关于 handoff
Handoff 是用于在 Agent 之间创建或恢复简明工作交接的技能。它在记录可执行上下文的同时,执行敏感信息脱敏、篇幅限制和过期材料检查。
主要功能
- 01创建或恢复交接文件
- 02对敏感值脱敏
- 03校验章节与篇幅限制
- 04检查引用材料是否变化
适用场景
- 01向其他 Agent 传递当前工作上下文
- 02从已保存的交接中恢复任务
- 03分享后续步骤且不泄露凭据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ prathamdby/ skills --skill handoff安装后在 Claude Code 中输入/handoff确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
REFERENCE.mdreferences/create.mdresume.md详细介绍
交接
路径与隐私
默认创建路径:<anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md,其中 anchor
为此技能的绝对目录。“Save to ”会选择在该路径创建;
“resume ”会选择恢复。两者同时出现、缺少值,或必需的 Context/Open tasks
格式错误,都会导致流程受阻。将所有路径解析为绝对路径。
已命名的当前焦点会覆盖保存的焦点。
对令牌/ Cookie、密钥、密码/连接凭据、私有或
需要身份验证的 URL、电子邮件/PII、证书和环境变量值进行脱敏。
这些值使用 [REDACTED: token]、[REDACTED: password]、[REDACTED: private-key]、
[REDACTED: pii] 或 [REDACTED: url] 替换。
环境变量值替换为 NAME=[REDACTED]。保留变量名、命令
形式、退出代码和产物指针,不保留敏感值。
绝不为了让命令可复制而降低脱敏级别。
不包含完整差异、计划、日志或转录。
上限为 12 KB、八项未完成任务、十二个产物;每个分节一到五条要点,省略空的可选分节。
创建
- 解析可写入的路径/父目录。记录
create | path | facts | redaction | written | terminal。 完成条件:可以写入输出。 - 选取当前且可执行的事实:计划、分支/PR/提交、未提交的路径、
阻碍因素、持久决策;标记已被取代的内容。应用
references/create.md起草必需分节和工作流状态。 完成条件:每条事实都有助于下一个 Agent 采取行动。 - 对草稿进行两次敏感值扫描,验证上限/分节,通过同级临时文件进行原子 替换,然后扫描最终文件。 完成条件:结构、上限、三次扫描和现有文件均通过验证。
- 报告路径、记录的范围,以及
resume the handoff at <absolute-path>。 完成条件:文件和恢复指示均已就绪。
恢复
- 解析/读取;若不存在 → 使用路径标记为 BLOCKED。记录
resume | focus | artifact status | task | terminal。 完成条件:必需的 Context/Open tasks 格式有效。 - 应用
references/resume.md验证路径、分支/未提交状态、提交、 PR 和已安装的技能;将其分类为当前/已移动/缺失/已取代。 读取所引用的产物时进行脱敏。完成条件:过时事实无法用于采取行动。 - 在当前焦点下选择优先级最高且不受阻碍的任务并开始执行, 仅恢复该任务的产物上下文。没有任务 → 提供有证据的 BLOCKED 状态,而不是 另一份摘要。完成条件:成功、遇到实际阻碍或进入确认关卡。
- 报告变化情况和工作结果。除非收到请求,否则不创建新的交接文件。
终态:SUCCESS、BLOCKED、AWAITING_USER、INTERRUPTED,并附上证据。 中断后,重新验证上次验证以来改动过的产物。
评论
支持 Markdown