mcpField
H
handoff

handoff

github.com/prathamdbyAgent 工作流6624 次安装3 天前更新
代码仓库

关于 handoff

Handoff 是用于在 Agent 之间创建或恢复简明工作交接的技能。它在记录可执行上下文的同时,执行敏感信息脱敏、篇幅限制和过期材料检查。

主要功能

  1. 01创建或恢复交接文件
  2. 02对敏感值脱敏
  3. 03校验章节与篇幅限制
  4. 04检查引用材料是否变化

适用场景

  1. 01向其他 Agent 传递当前工作上下文
  2. 02从已保存的交接中恢复任务
  3. 03分享后续步骤且不泄露凭据

安装

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

$npx skills add https://github.com/prathamdby/skills --skill handoff

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

包含的文件

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

REFERENCE.md
references/
create.md
resume.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、八项未完成任务、十二个产物;每个分节一到五条要点,省略空的可选分节。

创建

  1. 解析可写入的路径/父目录。记录 create | path | facts | redaction | written | terminal。 完成条件:可以写入输出。
  2. 选取当前且可执行的事实:计划、分支/PR/提交、未提交的路径、 阻碍因素、持久决策;标记已被取代的内容。应用 references/create.md 起草必需分节和工作流状态。 完成条件:每条事实都有助于下一个 Agent 采取行动。
  3. 对草稿进行两次敏感值扫描,验证上限/分节,通过同级临时文件进行原子 替换,然后扫描最终文件。 完成条件:结构、上限、三次扫描和现有文件均通过验证。
  4. 报告路径、记录的范围,以及 resume the handoff at <absolute-path>。 完成条件:文件和恢复指示均已就绪。

恢复

  1. 解析/读取;若不存在 → 使用路径标记为 BLOCKED。记录 resume | focus | artifact status | task | terminal。 完成条件:必需的 Context/Open tasks 格式有效。
  2. 应用 references/resume.md 验证路径、分支/未提交状态、提交、 PR 和已安装的技能;将其分类为当前/已移动/缺失/已取代。 读取所引用的产物时进行脱敏。完成条件:过时事实无法用于采取行动。
  3. 在当前焦点下选择优先级最高且不受阻碍的任务并开始执行, 仅恢复该任务的产物上下文。没有任务 → 提供有证据的 BLOCKED 状态,而不是 另一份摘要。完成条件:成功、遇到实际阻碍或进入确认关卡。
  4. 报告变化情况和工作结果。除非收到请求,否则不创建新的交接文件。

终态:SUCCESS、BLOCKED、AWAITING_USER、INTERRUPTED,并附上证据。 中断后,重新验证上次验证以来改动过的产物。

评论

支持 Markdown