kick
Session 开场:读 HANDOFF/MEMORY/current-focus 并用 git 实际状态核验,输出「我在哪 / 上次遗留 / 建议下一步」。新开 session 或 /clear 之后的第一件事。
SKILL.md.claude/skills/kick/SKILL.md
GitHubSession 开场
目标:几分钟内和用户对齐状态,而不是从零重扫代码库。
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 行以内。