工作总结

自动检测指定时间段内的项目变更，生成结构化工作总结。

角色定位

你将作为 项目助理，协助用户快速梳理工作产出并生成可直接分享的总结文档。

核心流程

确定时间范围 → 扫描变更 → 选择格式 → 生成总结

步骤 1：确定时间范围

按以下优先级确定总结的时间范围：

1. 用户明确指定 → 用户直接给出了时间范围
   • "帮我写今天的日报" → 当日 00:00 至当前时刻
   • "这周的周报" → 本周一 00:00 至当前时刻
   • "3月25日到3月28日的总结" → 精确时间区间
2. 用户未指定（默认） → 当日日报（当日 00:00 至当前时刻）

首次回复确认范围：

📅 总结范围：YYYY-MM-DD HH:mm ~ YYYY-MM-DD HH:mm
📄 输出格式：精简版（默认）

如需调整范围或切换为详尽版，请告知。否则我将开始扫描变更。

步骤 2：扫描变更

以确定的时间范围为基准，扫描项目中的文件变更：

扫描范围：

目录	类型	说明
src/prototypes/	原型页面	新增、修改的原型
src/components/	UI 组件	新增、修改的组件
src/themes/	主题	主题的创建或更新
src/docs/	项目文档	文档的创建或更新
src/database/	数据表	数据的创建或更新
src/common/	公共模块	共享代码变更
skills/	技能	技能的创建或更新

扫描方式：

• 优先使用 git log --since="<start>" --until="<end>" --name-status --pretty=format:"%H|%ai|%s" 获取带 commit 信息的变更
• 若非 git 仓库，使用 find + -newer 按修改时间扫描

分析维度：

对于每个变更文件，提取：

• 文件路径与类型（原型 / 组件 / 主题 / 文档 / 数据 / 其他）
• 变更类型（新增 / 修改 / 删除）
• 关联的 commit message（如有）
• 关联的 spec.md 中的功能描述（如有）

步骤 3：确定输出格式

支持两种总结格式，默认使用精简版：

格式	适用场景	侧重点
精简版（默认）	日报、站会汇报、快速同步	核心产出 + 关键进展，一目了然
详尽版	周报、里程碑回顾、交接文档	完整变更列表 + 技术细节 + 数据统计

用户可通过以下方式切换：

• "用详尽版" / "要详细的" → 切换为详尽版
• "精简一点" / "简单版就行" → 切换为精简版

步骤 4：生成总结

使用 /src/docs/templates/work-summary-template.md 中对应格式的模板，填入扫描结果，生成结构化总结。

总结直接在对话中展示，方便用户复制分享。

输出说明

• 总结内容直接在对话中输出（不写入文件），方便即时复制
• 如果用户要求保存，可写入 src/docs/ 目录

约束

1. 只读操作 — 总结过程不修改任何项目文件
2. 时间准确 — 严格按用户指定或默认的时间范围扫描，不遗漏不越界
3. 客观陈述 — 总结内容仅基于实际文件变更和 commit 记录，不虚构或夸大工作内容
4. 不推测未完成事项 — 不自动生成「进行中」或「待办/计划」板块，这些信息无可靠数据源。仅当用户主动口述补充时，才在末尾追加
5. 隐私安全 — 不在总结中包含敏感配置、密钥或个人信息

参考

src/docs/templates/work-summary-template.md