kick

Session 开场:读 HANDOFF/MEMORY/current-focus 并用 git 实际状态核验,输出「我在哪 / 上次遗留 / 建议下一步」。新开 session 或 /clear 之后的第一件事。

SKILL.md

GitHub

Session 开场

目标:几分钟内和用户对齐状态,而不是从零重扫代码库。

allowed-tools 声明的是本轮免批准的范围,不是硬限制。超出它的命令(比如下面的 # TODO(填测试命令))仍然能跑,只是会多一次权限确认——这是刻意的:开场不该悄悄执行任意命令。

第 1 步 读状态

并行读,别一个个来:

  • HANDOFF.md —— 上次 session 的状态,只看最上面那一节(最新在上)。 会过期,当线索不当事实。
  • .context/current-focus.md —— 当下焦点。
  • MEMORY.md —— 跨 session 的 [LEARN:tag] 教训,全读。
  • research-log.md —— 只读尾部 30 行(tail -n 30)。全文会吃掉 context 预算。

第 2 步 核验(不能省)

交接文档是上一个 agent 写的,可能写错、也可能已被后续操作推翻。用实际状态对账:

git status --short
git log --oneline -5

对照检查:

  • HANDOFF 说「已完成 X」,但 X 涉及的文件在 git status 里还是脏的、或 git log 里没有对应提交 → 存疑。
  • HANDOFF 说「测试通过」→ 需要时跑一次 # TODO(填测试命令) 实测(会弹一次权限确认,正常),不要转述。
  • 最近一次提交时间距今很久 → 整份 HANDOFF 都要打折。
  • 有未提交改动 → 先讲清楚这些改动是什么,再谈下一步。

文档与实际不一致时明确指出来,不要悄悄以文档为准。

第 3 步 输出(固定三段)

我在哪

2-4 行:分支、工作区是否干净、上次做到哪。与 HANDOFF 有出入的地方标出来。

上次遗留

HANDOFF 的 PENDING 逐条列出,每条注明「已确认 / 存疑 / 已失效」。

建议下一步

给 2-3 个选项,每个一行,说清代价和入口。例:

  • A) 接着做 PENDING 里的 X —— 改动小,直接 /impl
  • B) 先 /plan 查 Y 的根因 —— 需要调研,约一轮
  • C) 先 /exp 复现上次那个异常数值 —— 先有数据再决定

硬约束

  • 不要开始改代码。 本 skill 只负责对齐状态 + 给选项,等用户选。
  • 不要提出 HANDOFF 和 current-focus 里都没有的新方向。
  • 读不到某个文件就说读不到(新项目很正常),不要脑补内容。
  • 本 skill 每个 session 都加载,输出要短:三段合计控制在 30 行以内。