# REQUIREMENTS —— 结题报告初稿助手（draft-closing-report-default）

> 需求来源：《核心建设内容：各部门"Skill"深度需求规格书》§4.1 科研处 Skill 002（结题报告"一键初稿生成"）。
> 详细设计见工作区《科研处Skill002-结题报告一键初稿生成-开发文档.md》。
> 定位原则：辅助非决策、审慎非激进 —— 数据章节模板生成零差错；叙事只给素材要点，严禁编造。

## 0. 技能标识

- slug：`draft-closing-report-default`（draft ∈ 动词白名单；4 段 28 字符）
- 中文 name：结题报告初稿助手
- account-manager platform_key：不适用；网页 RPA 登录策略：`not_needed`
- 特有依赖：requirements.txt 声明 `python-docx>=1.1.0,<2`

## 0.1 宿主入口定位

| 主能力（Action id / CLI） | 对话 | 数据管理 | 定时 | 教程章节 | 不挂理由 |
|---------------------------|------|----------|------|----------|----------|
| `draft-report`（sync） | 挂 | toolbar（bind closing_projects，表单） | 不挂 | 入口一/入口二 | 生成由人发起并须本人核对 |
| `draft-batch-pending`（async） | 挂 | 不挂 | 不挂 | 入口二 | 批量初稿仍须本人逐份核对 |
| `add-project` / `add-achievement` / `add-expense` | 不挂 | toolbar（对应表，表单） | 不挂 | 入口一 | 结构化录入 |
| `import-data`（import，三类 JSON） | 挂 | 不挂 | 不挂 | 入口二 | 批量 JSON 走对话 |
| `list-data` / `list-drafts` / `stats` | 挂 | 仅展示表 | 不挂 | 入口二 | 查询类 |
| `render-html` | 挂 | toolbar（bind report_drafts）+ skill-detail | 不挂 | 入口一/入口二 | 预览重建 |
| `health` / `version` / `config-path` | 不挂 | 不挂 | 不挂 | N/A | 运维诊断 |

整技能无 cron placement："到期前提醒"依赖宿主通知能力属扩展；`TUTORIAL.md` 入口三已写明。

## 0.2 AI + RPA 协作与授权边界

- 本技能**无 RPA**；不连接科研/财务系统；台账由用户录入或导入。
- 叙事正文的 LLM 起草由宿主 Agent 承担（硬规则：只重组给定素材、逐句可溯源）；技能内核不调用大模型 API。
- 禁止路线（全技能适用）：破解/逆向/私有协议等，本技能不涉及。

## 0.3 业务行生命周期

不适用：初稿为同步生成 + 本地文件写出，无处理队列。

## 4. 功能范围（必须实现）

- 基座命令（`run` 为模板演示占位）
- `add-project` / `add-achievement` / `add-expense` / `import` / `list`
- `draft-report`（主命令）/ `draft-batch-pending`（async）/ `list-drafts` / `show-draft` / `render-html` / `stats`
- 业务表 4 张 + 展示元数据；`assets/actions.json` 按上表声明

可后续扩展：科研/财务系统直连、结题提醒定时、多机构模板、图表嵌入、叙事全自动。

## 6. 输入输出

- 输入：结题项目（含 expected_json 预期指标）、成果（type/title/venue_or_no/ach_date/is_representative）、决算（category/amount/occurred_date/description）、年度报告摘句
- 输出：JSON（`ok/batch_no/draft_id/project_no/draft_file/preview_file/completion`）；`ERROR:PROJECT_NOT_FOUND|PROJECT_INVALID|DRAFT_NOT_FOUND|QUERY_FAILED|ENTITLEMENT_DENIED`
- 文件：`output/结题报告初稿-{project_no}.docx`、`html/draft-{id}.html`、`html/draft-preview.html`

## 9. 验收标准

- slug/版本三处一致（1.0.1）；套件全绿（含 python-docx 环境）
- 金标准覆盖 C1 边界（超额/持平/未达标/待补）、C3 占比合计、C4 来源标注、C5 章节顺序、W1 占位、docx 内容断言
- 三场景真实跑通：全量数据、缺年度报告（叙事占位）、缺决算（决算占位）；批量模式全流程
- `actions.json` 与定位表、TUTORIAL 一致；`developer_ids`=79017；发布链路 success；宿主多入口验收（含 Word 下载打开）

## 11. 变更记录

| 日期 | 版本 | 变更人 | 内容 |
|------|------|--------|------|
| 2026-09-13 | v1.0 | 开发组 | 初版 |