--- name: daily-review description: 每日复盘——Hermes 工作复盘 + 火星人个人复盘。KPT 框架,对照日报内容提问补全信息,梳理得失,制定次日计划。触发词:复盘、review、日报、总结、今天做了什么、KPT。 category: productivity --- # 每日复盘 Skill ## 触发条件 - 「复盘」「review」「总结一下今天」「今天做了什么」 - 每天结束时的例行回顾 - 用户表达了目标但结果有偏差,需要分析 ## 双重复盘结构 本 skill 服务于两个复盘对象,每次复盘时**先 Hermes 后火星人**,各自独立成章: ``` ┌──────────────────────────────────────────┐ │ 一、Hermes 工作复盘 │ │ KPT + 任务清单 + 问题追踪 + 次日计划 │ ├──────────────────────────────────────────┤ │ 二、火星人个人复盘 │ │ 目标对照 + 差异分析 + 决策回顾 + 改进 │ └──────────────────────────────────────────┘ ``` --- ## 一、Hermes 工作复盘 ### 1.1 数据来源 从 session history 提取今天的所有工作记录: - 完成了哪些任务(代码提交、脚本编写、bug 修复、系统配置) - 遇到了什么问题(报错、权限、依赖缺失、设计缺陷) - 用户反馈了什么(表扬、批评、纠正、新需求) **跨天 session 处理**:session_search 返回的 `when` 字段是 session 最后活跃时间,不是单条消息的时间。一个 session 可能跨多天(如 431 条消息跨 7/19-7/21)。正确做法: 1. `session_search()` browse 模式拿到近期 session 列表 2. 对跨天 session,用 `session_search(session_id=..., around_message_id=...)` 逐段滚动,按 message timestamp 判断每段属于哪天 3. 用 `session_search(query="关键词", sort="newest")` discovery 模式按内容主题定位,再 scroll 看时间戳 4. timestamp 是 Unix epoch,用 `datetime.fromtimestamp(ts)` 转日期判断归属 **去重检查**:写盘前先检查 `.hermes/reviews/` 目录下是否已有目标日期的文件。如果已有,读取内容确认是否是误标日期(如 7/20 的工作误写到 7/21.md),如果是则迁移到正确日期文件。 **问题连续性追踪**:复盘前先读取前一天(及前两天)的复盘文件中「待解决问题」部分。今天的待解决问题列表应当: 1. 继承前一天的未解决问题(标注 [继承]) 2. 如果某个问题已解决,标注 ✅ 已解决 3. 检查同一问题是否连续出现——这是 1.4 节「连续 3 天升级为系统性问题」规则的数据来源 ### 1.2 KPT 框架 | 维度 | 说明 | |------|------| | **K**eep | 做得好的,值得继续保持的做法 | | **P**roblem | 出问题的,需要解决的 bug/设计缺陷/流程漏洞 | | **T**ry | 下次尝试的新做法、待验证的改进方案 | ### 1.3 任务完成清单 逐条列出今天承诺或开始的任务: | 任务 | 状态 | 产出 | 备注 | |------|------|------|------| | xxx | ✅/⚠️/❌ | 文件/Skill/代码 | 遇到什么问题 | ### 1.4 待解决问题追踪 从今天没解决的问题中挑出需要关注的,标注优先级和阻塞原因。 **问题继承机制**: - 复盘时先读前一天复盘文件的「待解决问题」部分 - 未解决的问题标记 [继承] 带入今天的列表 - 已解决的问题标注 ✅ 已解决(简述解决方式) - 同一 Problem 连续出现 3 天 → 在本节底部标注「⚠️ 系统性问题」并按记录原则第 3 条升级 ### 1.5 次日计划 基于今天未完成和用户明确提出的需求,列 3-5 条明日 TODO。 --- ## 二、火星人个人复盘 ### 2.1 提问模板 不要一次性全问——根据用户当天聊到的内容,**一次一个问题**,逐个收集: **目标层**: - 「今天主要想推进什么事情?」 - 「今天的核心目标达成了几成?0-10 分打几分?」 **执行层**: - 「今天有没有什么事情进展比预期顺利?为什么?」 - 「有没有卡住或拖延的事?根因是什么?」 **决策层**: - 「今天有没有做了某个决定,回头看觉得不太对的?」 - 「如果今天重来一次,你会改变哪一件事?」 **感受层**: - 「今天整体状态怎么样?精力/专注度如何?」 - 「有没有让你特别兴奋或特别沮丧的时刻?」 ### 2.2 AAR 框架(目标→现实→差异→改进) 当用户表达了明确的目标后,用 AAR 结构整理: ``` 目标: [用户期望达成的] 现实: [实际发生的] 差异: [目标和现实的差距] 根因: [为什么会这样] 改进: [下次怎么做] ``` ### 2.3 KPT 框架(个人版) | 维度 | 说明 | |------|------| | **K**eep | 今天做的决定/行动中值得保持的 | | **P**roblem | 遇到的阻碍、判断失误、精力问题 | | **T**ry | 明天想尝试的新方法/习惯/策略 | --- ## 三、复盘日报输出格式 ```markdown # 复盘日报 — YYYY-MM-DD ## 🤖 Hermes ### KPT - K: ... - P: ... - T: ... ### 今日完成 | 任务 | 状态 | 产出 | |------|------|------| | ... | ✅ | ... | ### 待解决问题 - [P0] ...(阻塞原因:...) - [P1] ... ### 明日计划 1. ... 2. ... ## 👤 火星人 ### 目标对照 - 目标: ... - 现实: ... - 差异: ... ### KPT - K: ... - P: ... - T: ... ### 关键洞察 - ... ``` --- ## 提问原则 1. **一次一个问题**:不等用户全部回答完再整理,边问边记 2. **先事实后判断**:先问「发生了什么」,再问「为什么」 3. **不诱导**:不问「是不是因为太累了?」而问「你觉得主要原因是什么?」 4. **追问细节**:用户说「今天效率低」→「具体哪个时间段?在做什么的时候?」 5. **尊重沉默**:用户不想展开的点,标注「未展开」跳过 ## 记录原则 1. 复盘内容写盘到 `.hermes/reviews/YYYY-MM-DD.md` 2. 关键改进项同步写入 memory(防止遗忘) 3. 连续 3 天出现的同一个 Problem → 升级为「系统性问题」,单独建 Skill 或改流程 ## 多Agent任务验收方法 当用户要求检查 cron job 执行的开发任务时(如 Plan/Dev/Test Agent Loop 产出的飞书需求),验证方法: 1. **查飞书需求表状态**:用 `pipeline_api.fetch_all(RT)` 拉取全部记录,检查目标任务的 `状态` 字段是否为「已完成」、`Sprint审核` 是否为「通过」 2. **验证实际产出**:状态=已完成不等于真做对了。必须实际验证: - `curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:5001/` 检查页面是否存在 - `curl -s http://127.0.0.1:5001/api/` 检查 API 是否返回正确 JSON - `ls -la` 检查文件是否存在 - `grep -n` 检查代码是否包含预期函数 3. **检查 cron 执行状态**:`cronjob action='list'` 查看各 job 的 `last_status`、`last_run_at` 4. **日报验证**:检查日报文件的日期是否正确(不混入其他日期的文章)、日报是否注册到 reports 表 5. **skill 修改验证**:如果任务包含修改 skill,用 `skill_view` 确认修改是否生效 **关键原则**:状态字段是 Agent 自报的,实际产出必须自己验证。一个任务标记「已完成」但 `/agents` 返回 404 = 没做对。 ## 多 Agent 架构验证 当系统使用多 profile 架构时(如 planning agent 运行在独立 profile 下),复盘需额外检查: 1. **profile 隔离验证**:planning profile 的 SOUL.md 不应包含 default 的人格内容(用 `diff` 确认)。skills 目录应只有规划相关的 4 个 skill,不是 default 的 330 个 2. **cron job 身份验证**:Plan Agent cronjob 的 prompt 应包含 "Planning Agent" 身份声明,skills 字段应为空(prompt 自包含指令,不依赖 skill 加载) 3. **Agent 切换验证**:/chat 页面的 Agent 下拉列表切换后,stream API 应调用 `hermes -p ` 而非默认 `hermes` 4. **default 隔离验证**:default profile 的 `.usage.json` 中 plan-agent 应为 `disabled`(不在系统提示中加载)