mcpField
H
hand-off

hand-off

github.com/dyritsAgent 工作流048 次安装1 天前更新
代码仓库

关于 hand-off

hand-off 是用于记录工作交接的 Agent 技能，让未安装该技能的新 Agent 也能在不同运行环境中继续工作。它按指定格式编写交接文档，并通过 AGENTS.md 指向文档。

主要功能

  1. 01创建结构化交接文档
  2. 02延续或分叉交接线程
  3. 03记录本地或共享交接
  4. 04更新 AGENTS.md 指针
  5. 05按格式核验文件

适用场景

  1. 01将进行中的工作交给新 Agent
  2. 02将旁支任务记录为独立线程
  3. 03为后续会话整理代码库

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dyrits/skills --skill hand-off

安装后在 Claude Code 中输入/hand-off确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

apm.yml
agents/
openai.yaml
references/
handoff-format.md

详细介绍

编写一份交接文档，让一个全新的 Agent 无论使用哪种运行环境、是否安装了技能，都能继续这项工作。先阅读 handoff-format.md，并严格遵循其中的格式。

步骤

  1. 确定采用本地还是共享方式。 如果 .agents/handoffs/ 已列在 .gitignore 中（仅本地保存）、较早的交接文档已纳入版本控制（共享），或 AGENTS.md 中有说明，仓库就已给出答案；请据此处理，不要询问。否则只询问一次：将 .agents/handoffs/ 加入 .gitignore，以便仅在本地保留历史记录；还是提交交接文档，以便共享历史记录。
  2. 将文档放入对应线程。 列出 .agents/handoffs/。如果本次会话延续了一个已有交接文档的线程（即本次恢复所依据的交接文档所属线程，或本次会话先前写过交接文档的线程），则取代该线程最新的交接文档。由当前工作分支出的旁支任务，从当前线程分支出新线程。其他情况均开启新线程。
  3. 按照模板的章节及顺序，在对应标题下编写新文件，并包含“To resume”段落。在将某项状态标记为已验证之前，先检查该项（读取文件、运行命令）；否则标记为假定。如果用户传入了参数，这些参数描述的是下次会话要聚焦的内容：据此撰写 Goal 和 Next。
  4. 更新最近的 AGENTS.md 中的指针，遵循格式文档的 Pointer 部分：替换本线程的指针行，或新增一行，说明交接文档是共享的还是仅保存在本地。如果不存在 AGENTS.md，则创建该文件并添加这一行。
  5. 按照格式检查两个文件：确认所有章节均存在且顺序正确，“To resume”段落完整无缺，supersedes 行所指的文件确实存在，没有抄录源文件已记录的内容，没有泄露任何机密，并且恰好只有一行 AGENTS.md 条目指向本线程的新文件。
  6. 打印完整路径，并告知用户，下次会话可通过 AGENTS.md 找到该文件，也可以直接提供该路径。

评论

支持 Markdown