draft-closing-report-default/development/REQUIREMENTS.md

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	开发组	初版