用途:在编码智能体会话之间做交接,用受人类控制的文件结束一次会话并启动下一次会话,而不是依赖不可检查的上下文压缩。适用于任何代码库,也适用于没有 git 的普通文件夹。
主要能力:在仓库根目录建立 _agent/ 目录,其中 _agent/docs/ 放工作笔记,_agent/handoff/ 放步骤日志;每个目标一个文件夹,步骤文件按两位数字加短横线 slug 命名,排序后的 ls 即阅读顺序,最新文件为准。不设索引与 README。每个步骤固定五个段落:Goal(逐字复制、防止漂移)、Done(已完成的事实)、Where we are(分 Verified 与 Believed)、Next(下一步三步与禁止事项)、Session(会话 id 与恢复命令、验证命令)。_agent/ 永不提交,会被写入 .git/info/exclude;在 worktree 中使用 --git-common-dir 保证日志写在主检出、不随 worktree 删除。
使用方式:无参数时进入写入模式并从分支名推断目标,分支无工单号或没有 git 时用 kebab-case slug,含糊则询问,绝不编造工单号。参数 resume [TICKET-or-slug] 表示当前是新会话,只打开最新步骤、必要时打开工作笔记 README,先读 Goal 与 Next,运行 Session 中的验证命令后再信任 Where we are,发现文件与代码树不一致要先说明。参数 <TICKET-or-slug> ["step description"] 表示正在结束会话。可用 to <agent> 或 --to <agent> 指定下一会话的智能体,默认是当前智能体。支持为 claude、codex、grok、gemini、opencode、cursor 生成启动命令;若在 Orca worktree 中,可用命令行创建终端并拉起新会话,失败则给出可粘贴的手动回退命令。
适用场景与限制:最佳时机是验证通过的里程碑之后、上下文窗口退化之前;会话出现重复错误或窗口将满时作为应急使用。由人类决定何时交接,不依据上下文大小自动触发。技能不提供收费、价格或平台效果等信息,资料未涉及。命令与文件名格式需按原文保持,缺失事实暂未提供。