Files
draft-closing-report-default/TUTORIAL.md
chenfuqiang 7b24521b43
All checks were successful
技能自动化发布 / release (push) Successful in 6s
feat: 结题报告初稿助手首版 v1.0.1(draft-closing-report-default)
2026-09-13 16:04:01 +08:00

73 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
数据管理与对话任务是本技能两种**平行**的用法:科研秘书在表上维护台账、点生成,走数据管理;教师直接要初稿,走对话。本技能不提供定时任务(初稿须本人核对后使用,批量生成也由人在评审季发起)。
## 本技能做什么
技能维护四份数据:结题项目(含预期成果指标)、成果清单、决算明细、初稿记录。生成初稿时:① 对比预期与实际成果,按类型标记 超额完成/持平/未达标,自动写"完成情况"章节;② 把决算流水按科目汇总并转成规范描述句,写"经费决算"章节;③ 从代表性成果与年度报告摘句提取叙事素材要点;④ 按"背景-进展-完成情况-决算-成果清单-展望"骨架组装 Word 初稿与 HTML 预览。1/2/6 章为素材+占位,须本人撰写。
## 开始前
- 录入结题项目与预期指标(JSON 数组,如 [{"type":"论文","target":3,"unit":"篇"}])
- 录入成果清单与决算明细(可从科研系统/财务导出整理后批量导入)
- 确认需要 Word 文件(python-docx 依赖已随技能安装)
## 入口一:数据管理
左侧表列表中能看到本技能的四张表:结题项目、成果清单、决算明细、初稿记录。
### 录入台账
1. "结题项目"表点顶栏「录入结题项目」:项目编号必填,预期指标粘贴 JSON;同一编号再次提交即更新
2. "成果清单"表点顶栏「录入成果」:选类型、填名称与期刊/专利号;代表性成果设为 1
3. "决算明细"表点顶栏「录入决算明细」:科目、金额(元)、日期
### 生成初稿
1. 在"结题项目"表点顶栏「生成结题初稿」,填项目编号提交
2. 完成后初稿记录表出现记录;左侧 HTML 报告区打开 `draft-preview`/`draft-编号` 预览
3. Word 文件路径在初稿记录的"Word 初稿"列,从 output 目录取用
## 入口二:对话任务
新建任务,选择本技能后直接说事。
### 生成初稿
> 帮我生成 NSFC2026003 的结题报告初稿
助手生成后报出 Word 文件路径,并解读完成情况(哪些超额、哪些未达标)与素材要点数量。
### 批量生成
> 把所有待结题项目都生成初稿
助手批量生成并逐项汇报进度与结果(任务中心可见)。
### 补录与查询
- "录入一篇论文:《某某研究》,Applied Energy,2026-05" → 成果入库
- "查一下 X 项目的决算" → 返回明细
- "重新生成初稿预览" → 重建 HTML
## 入口三:定时任务
本技能不需要定时:初稿须本人核对后使用,批量生成也在评审季由人发起;"到期前提醒"依赖宿主通知能力,属后续扩展。
## 主能力对照表
| 能力 | 数据管理 | 对话任务 |
|------|----------|----------|
| 生成初稿(单项目) | 「生成结题初稿」按钮 | 直接说项目编号 |
| 批量生成 | 不支持 | 支持(进任务中心,有进度) |
| 录入台账 | 顶栏按钮 + 表格直改 | 对话说明信息 |
| 查看预览 | 「重建初稿预览」+ 侧栏 | 让助手重建后打开 |
| 查询与统计 | 初稿记录表 | 对话查询 |
| 定时生成 | 不提供 | 不提供 |
## 常见卡住怎么办
- **提示"项目不存在或状态不是待结题"**:先在"结题项目"录入该项目,状态为"待结题"
- **完成情况全是"未达标"**:成果清单没录入或类型与预期指标不一致(类型须为 论文/专利/人才培养/其他)
- **Word 打不开/没有生成**:python-docx 依赖异常,重装技能;先用 HTML 预览查看内容
- **叙事章节只有素材**:这是机制设计——素材要点来自你的成果与年度报告,正文须本人撰写
- **决算章节提示"明细尚未录入"**:在"决算明细"表补录后重新生成