| name | summary |
| description | 生成开发总结文档,记录交付物、依赖、设计要点。在 dev-flow 流程的第 8 步自动加载。 |
| version | 1.1.0 |
总结 · 输出格式
你的任务
在整个流程完成后,生成 总结.md,记录本次开发的全部交付物和关键信息。
输出格式
参考以下模板生成 总结.md:
# <项目名称>(<负责人>)· 开发总结
> 日期:<日期> | 范围:<本次涉及的任务列表>
## 一、交付文件
### Story A <任务 1 名称>(IDxxxxxxx)
- `<文件路径 1>` — <简要说明>
- `<文件路径 2>` — <简要说明>
- `<文件路径 3>`
- <具体改动点 1>
- <具体改动点 2>
### Story B <任务 2 名称>(IDxxxxxxx)
- `<文件路径 1>` — <简要说明>
- `<文件路径 2>` — <简要说明>
## 二、上线前依赖(业务方/其他人)
1. **<依赖 1>**:<说明>
2. **<依赖 2>**:<说明>
## 三、设计要点
- <关键设计决策 1>
- <关键设计决策 2>
- **视觉规格落地**(涉及 UI 时):按 PRD 截图/原型落地的位置与文案,逐项对齐记录(列归属/合并、按钮精确文案、所在页签、筛选与字段顺序);与图不一致或图中未给、由我方拍板的,单独标出并说明理由
## 四、已知待联调
- <需要和其他人联调的事项>
- <需要验证的功能点>
格式要求
- 头部署名:标题中的「负责人」取第 0 步解析出的个人标识(
person)
- 交付文件:按任务分组,列出所有修改/新增的文件
- 上线前依赖:需要其他人/业务方配合的事项
- 设计要点:关键技术决策和理由
- 已知待联调:还没验证、需要联调的事项
写入规则
- 文件路径:
<session_dir>/总结.md
- 编码:UTF-8
- 如果文件已存在,询问用户是覆盖还是追加
维护工作区 总览.md(可选,需 --overview)
仅当本次运行传入 --overview 才执行;否则跳过。 完整规则(定位、项目分组、写行、新建模板)见 dev-flow 命令的「总览维护」章节。
本步执行其中的收尾触点:生成 总结.md 后,把本次需求从「🔥 在办」移到对应项目的「✅ 已完成」,状态 ✅,产出列填本次会话目录的相对链接,并更新顶部日期。若开始时(第 1 步)因未定位到 Prd/ 工作区而跳过登记,则本步同样跳过。
注意事项
- 交付文件要写完整路径,不要遗漏;涉及 UI 的改动,简要说明要点出落点(进哪列/是否合并、按钮文案、所在页签)
- 上线依赖要写清楚责任方
- 设计要点要简洁,说清楚「为什么这么做」
- 待联调项要具体,便于后续追踪
- 更新每个任务的
计划.md 状态为「已完成(详见 ../总结.md)」