agent-handoff-skill

Agent Handoff Skill

中文 | English

如果这个 skill 对你的 Agent 接力流程有帮助，欢迎给仓库点一个 Star，让更多人更容易找到它。

一个给 Codex / Claude Code / DeepSeek Harness（DSH）使用的 可持续接力机制 skill。

它解决的问题很朴素：AI Agent 很强，但会话窗口不是可靠的项目记忆。上下文会压缩，会话会中断，Agent 会更换，开发任务却还要继续。agent-handoff 的目标就是把“上一位 Agent 脑子里的状态”沉淀成仓库内可维护、可验证、可接手的项目文档。

它不是聊天总结工具，也不是把所有历史都塞进一个 Markdown 文件。它更像一份轻量的“项目飞行记录仪”：记录当前目标、状态、活跃文件、关键决策、验证结果、风险、阻塞点和下一步，让下一位 Agent 能快速、安全地继续工作。现在它还包含确定性的容量治理脚本，避免 snapshot 和历史日志在长期使用后无限膨胀。 平台兼容性

这个仓库里的 skill 不是只给 Codex 用。它采用通用的 SKILL.md + references/ + scripts/ 结构，可以按不同工具的发现路径安装： DSH 不会扫描 ~/.codex/skills、~/.claude/skills 或 /.claude/skills，需要把仓库安装或链接到上表中的 DSH 根目录。安装到默认根目录不需要修改 DSH profile、patch 或 settings。当前仓库里的 agents/openai.yaml 是 Codex UI 元数据；Claude Code 和 DSH 会忽略它。 dsh.so 市场元数据

仓库根目录的 package.json 是给 dsh.so 等目录服务读取的最小市场 manifest，包含 name、license、description、仓库地址和文件清单。它设置为 private，不代表这个 Skill 要发布到 npm，也不会改变 DSH 按 SKILL.md 发现和加载 Skill 的方式。

这个 manifest 主要解决 dsh.so 的 L2 结构化元数据检查；L3 还需要可解析的安装规范和声明的 DSH 版本，L4 才会在沙箱中实际安装。当前 Skill 不声明 npm 安装或 Cordis bundle 安装命令，因此不能把加入 package.json 误解为安装测试已经通过。

如果希望 dsh.so 通过 GitHub topic 自动识别仓库，可以在 GitHub 仓库设置中添加 dsh-plugin topic。这个 topic 是市场索引信号，不是 DSH profile 配置；当前仓库的实际运行入口仍然是 SKILL.md。 为什么会有这个 Skill

在长时间使用 AI Coding Agent 做真实项目时，常见断点通常不是“代码不会写”，而是这些更现实的问题： 新窗口打开后，Agent 不知道上一轮真正做到哪里。 上一位 Agent 做过技术决策，但没有记录原因和证据。 用户说“继续”，但当前目标、活跃文件、验证状态已经散落在旧聊天里。 一个复杂任务跨越多天、多模块、多次中断，最后没人能判断哪些内容已经完成。 接力文档越写越像聊天流水账，下一位 Agent 反而要读更多无关内容。 项目里有 CLAUDE.md、AGENTS.md、.claude/CLAUDE.md 等规则文件，但每个仓库的维护方式不一致。

agent-handoff 把这些经验固化为一个可复用 skill：它会指导 Agent 在仓库内创建或修复一套稳定的接力机制，并提供一个幂等 bootstrap 脚本，减少重复复制提示词和手工拼模板的错误。