SKILL.md 8.22 KB

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 框架

维度 说明
Keep 做得好的,值得继续保持的做法
Problem 出问题的,需要解决的 bug/设计缺陷/流程漏洞
Try 下次尝试的新做法、待验证的改进方案

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 框架(个人版)

维度 说明
Keep 今天做的决定/行动中值得保持的
Problem 遇到的阻碍、判断失误、精力问题
Try 明天想尝试的新方法/习惯/策略

三、复盘日报输出格式

# 复盘日报 — 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/<page> 检查页面是否存在
    • curl -s http://127.0.0.1:5001/api/<endpoint> 检查 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 <selected_profile> 而非默认 hermes
  4. default 隔离验证:default profile 的 .usage.json 中 plan-agent 应为 disabled(不在系统提示中加载)