开发与工程 session-handoffcontext-managementimplementation-planninggit-workflowtask-trackingbeads

Handoff Plan(交接规划)

把会话交接升级为可执行的分阶段计划:先完整采集会话数据,再产出下一会话可直接开工的实施计划,用任务链跨会话延续。

FollowSkills 评估 · FSRS-2.0
谨慎使用
47/ 100 五分制 2.4 / 5
1 2 3 4 5 6
1信任安全12 / 25 · 2.4/5

证据显示技能会写入文件、执行 git 提交并调用外部工具(bd),存在自动 commit 行为;有明确回滚要求(每阶段 Rollback)和文件命名规则,数据流透明度尚可,MIT 许可与来源可查。扣分点:提交与关闭为强制自动化流程,缺少对用户的显式确认门控,依赖的 /handoff 技能未在评审范围内完整可见,权限边界与敏感数据处理未声明。

2可靠稳定9 / 20 · 2.3/5

指令结构自洽,行数校验、检查点、回滚规则明确。扣分点:核心依赖 /handoff 技能与 bd/beads 工具的可用性与失败路径未定义;若 bd 不可用或行数不达标,失败反馈不完整;静态评审无法验证关键路径可复现,锚定上限为 10。

3适用触发8 / 15 · 2.7/5

场景清晰(会话交接+生成执行计划),触发词列举具体,命名与产物格式明确。扣分点:能力边界与非适用范围未声明;核心价值依赖 Claude Code 环境及海外服务(GitHub、Beads、OpenViking),对中国大陆网络可达性与中文支持无说明。

4规范维护8 / 15 · 2.7/5

文档分层良好,规则编号清晰,仓库含 MIT 许可与 README。扣分点:技能本身无版本号、变更日志或已知限制披露;维护责任与更新路径仅隐含于仓库归属;beads/记忆等可选依赖的条件分支有隐藏假设。

5有效结果6 / 15 · 2.0/5

声称产出可直接供下一会话执行的分阶段计划,含验证标准与回滚,边际价值明确。扣分点:README 的 A/B 测试结论无原始数据可核,静态评审无法确认计划产物可直接使用,上限为 7。

6证据核验4 / 10 · 2.0/5

有可审计的源文件、README 说明与许可,主张与结构可交叉对照。扣分点:效果声称(A/B 测试)仅有作者自述,无第三方执行证据或测试套件,静态评审上限为 5。

证据充分度: 评估于 2026年9月10日 审查版本 c407845e4c57
使用前请注意
  • 该技能会自动写入文件并执行 git 提交,使用前请确认会话内无不想被提交的无关改动。
  • 依赖 /handoff 技能及可选的 bd/beads、OpenViking 等外部工具,缺失时的降级行为未定义,可能中断或产出不完整计划。
  • 核心生态为 Claude Code 与 GitHub 托管服务,中国大陆用户需自行评估网络可达性;中文支持未声明。
  • 无技能级版本号与变更日志,升级时无法判断行为变化。
  • 效果数据(A/B 测试)为作者自述,未经独立验证。
评估证据 [1][2][3]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

handoffplan 是 REMvisual/claude-handoff 仓库中的第二个技能,与 /handoff 配套使用。它先执行完整的 /handoff 流程(含强制的两阶段写入)生成详尽的交接数据文件,然后在同一目录写出对应的 PLAN_ 分阶段实施计划,引用而非复制交接数据。计划包含问题陈述、关键发现、反目标、带回滚策略的各阶段实施步骤和可量化的成功标准。它还会用 bd(beads)为各阶段创建带依赖关系的任务、提交会话工作,并输出一段可粘贴到新会话的执行提示词,让下一会话直接从第一阶段开始写代码,无需重新探索。

1) 运行 /handoff 技能生成 HANDOFF_{chain_tag}_{slug}_{date}.md 数据文件,并执行强制的第二阶段(读回、扫描遗漏、扩展到行数下限:Quick 150/250、Deep 300、Chunked 500 行,上限 800 行);2) 在检查点校验行数后写出同目录同前缀的 PLAN_ 计划文件(120-250 行,2-5 个阶段),含目标、证据关联、反目标、文件清单、验证命令、回滚策略和 Quick Start;3) 用 bd create 为各阶段建任务并用 bd dep add 建依赖;4) 用 bd remember 持久化到记忆(如可用);5) 报告文件路径、行数和首个行动;6) 精准提交本次会话相关文件,输出格式化的提交信息,并给出粘贴到下一会话的执行提示词。全程不使用 Claude Code 内置 plan mode(它会写文件)。

  1. 研究阶段收尾的开发者:已找到方向、准备动手实现,想给下一会话一份直接可执行的计划
  2. 跨多天推进的长期功能开发:希望第三、第四次会话能直接从上次确定的方案开工,不再重复探索
  3. 使用 beads 做任务管理的团队:希望每个实施阶段自动变成带依赖关系的可追踪任务
  4. 深受上下文压缩困扰的用户:交接文件链条链式关联,新会话靠读文件恢复完整上下文
  5. 失败教训需要传承的场景:'What We Tried' 和反目标部分阻止下一会话重蹈已验证失败的路线

这个 Skill 有哪些优点和局限?

优点
  • 计划引用而非复制交接数据,避免双份维护,且每个阶段都必须追溯到证据
  • 反目标机制把已验证失败的方案显式排除,防止下一会话重复踩坑
  • 每个阶段强制附带回滚策略和基于基线数字的成功标准
  • 自动创建带依赖的任务链,并用统一命名(HANDOFF_*/PLAN_* 同前缀)保证文件配对可被清理工具找到
  • 粘贴提示词是执行导向的:下一会话不探索、不提问,直接开工
局限
  • 强依赖 /handoff 技能:没有它整个流程无法运行,必须成对安装
  • 流程较重:完整两阶段交接 + 计划 + 任务 + 提交,不适合只想快速暂停会话的场景
  • 明确禁止 Claude Code plan mode,且会直接写文件并提交 git,需要用户信任其自动提交行为
  • 行数下限(如 Chunked 500 行)可能促使生成为凑行数而冗长的交接文件
  • README 的 A/B 测试效果数据是作者自述,无独立验证;未提供自动化测试套件
  • 对 bd(beads)的依赖是'如可用'的软依赖,任务创建功能在无 bd 环境下的具体行为源文档未完整说明

如何安装这个 Skill?

从 https://github.com/REMvisual/claude-handoff 克隆仓库,然后:
git clone https://github.com/REMvisual/claude-handoff.git
cp -r claude-handoff/skills/handoff ~/.claude/skills/
cp -r claude-handoff/skills/handoffplan ~/.claude/skills/
注意:本技能依赖 /handoff 技能,两者必须同时安装。验证方式:在 Claude Code 中输入 /handoff 应出现在自动补全中。任务跟踪默认使用 bd(beads),但源文档未说明 bd 缺失时的具体降级行为。

如何使用这个 Skill?

在会话结束、准备实施时输入:
/handoffplan 可选:补充想规划的内容(作为问题陈述和阶段划分的软提示)
技能会自动完成交接、写计划、建任务、提交,并输出一段可粘贴的提示词。把它粘贴到全新会话,该会话会读取计划和交接文件,认领第一阶段并立即开始编码。也可用自然语言触发:'handoff with a plan'、'make this into a plan'、'plan this out' 等。

这个 Skill 与同类方案有什么区别?

与同仓库的 /handoff 是姊妹关系:/handoff 适合研究中途暂停——下一会话读交接后先上手和探索;/handoffplan 适合研究完毕准备实施——下一会话读计划后直接从第一阶段开始编码。作者还指出 Claude Code 内置的上下文压缩摘要是它针对的替代品,但认为后者缺少链条跟踪、自验证和证据挖掘。与 OpenViking 等持久记忆工具是互补而非竞争关系。

常见问题

我可以单独使用这个技能而不装 /handoff 吗?
不行。它的第一步就是完整执行 /handoff 技能,且规则明确禁止跳过或简化交接过程。两者必须一起安装到 ~/.claude/skills/。
它会自动提交我的代码吗?
会。第 6 步会执行 git status/diff 检查后,只提交本次会话相关的文件,并使用固定格式的提交信息。如果发现无关改动,它会提及但不会提交。
没有安装 beads(bd 命令)能用吗?
可以。技能标注为'如可用'时才创建任务,任务追踪也可换成 Linear、Jira CLI 或 GitHub Issues 等;没有链条标签时文件命名会退化为 HANDOFF_{slug}_{date}.md。
如果交接文件写得太短怎么办?
技能内置检查点:写计划前会核对行数下限(Quick 150/250、Deep 300、Chunked 500),不达标会停下来重跑第二阶段的补漏研究,扩展后才继续写计划——因为计划质量受限于交接质量。

同仓库的其他 Skills

均来自 REMvisual/claude-handoff

相关 Skills