Menü
Check pending handoff tasks from PM/SA, execute by priority
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | handoff |
| description | Check pending handoff tasks from PM/SA, execute by priority |
| disable-model-invocation | true |
| installed-from | agent-dev-standard@cf04193 |
| installed-on | "2026-05-29T00:00:00.000Z" |
从 <handoff_dir>/pending/ 目录消费上游（PM / SA）写入的待办任务。这是上游 → 执行层的主通道，消除"用户逐条转达"的动作。
背景： CLAUDE.md 描述式约定（"会话启动必扫描"）对 AI 无效。本 skill 是显式调用层兜底——用户主动
/handoff触发扫描。
pending/，按优先级 + 日期展示待办，等用户选择<filename> — 直接处理指定 handoff 文件--list — 只列出 pending，不进入执行--status — 统计 pending / in-progress / completed 数量| 项 | 值 |
|---|---|
handoff_dir | <project>/docs/handoff/（通常无需调整） |
README | <handoff_dir>/README.md（协议详细规范） |
install 时确认路径。通常就是
docs/handoff/。
test -d <handoff_dir>/pending || {
echo "❌ handoff 目录未初始化。请运行 /install handoff 或手动创建。"
exit
}
<handoff_dir>/pending/*.mdpriority + date + 一级标题📋 待处理 handoff：<总数>
1. [HIGH] YYYY-MM-DD <topic-a> (文件名.md)
2. [MEDIUM] YYYY-MM-DD <topic-b>
3. [LOW] YYYY-MM-DD <topic-c>
请选择要处理的编号，或输入 N 跳过。
如果 pending 为空：
📋 pending/ 为空，无待办任务。
不自行处理，等用户选。
用户选 N 后：
mv pending/<file>.md in-progress/<file>.mdstatus: in-progressstarted: YYYY-MM-DD HH:MM/issue、/audit、/fix 等其他 skill任务执行完成，按 handoff 文件里定义的"完成记录"要求：
status: completedcompleted: YYYY-MM-DD HH:MMmv in-progress/<file>.md completed/YYYY-MM/<file>.md
| 异常 | 处理 |
|---|---|
pending/ 不存在 | 提示运行 /install 或创建目录 |
| 文件 header 格式错误 | 跳过并警告，不阻塞其他文件 |
| 用户选的文件在处理前已被别的会话移走 | 重新扫描并提示 |
in-progress/ 里已有文件（上次中断） | 在清单里以 [IN-PROGRESS] 标注，允许继续 |
| 机制 | 职责 |
|---|---|
| 本 skill | 执行层消费 handoff 的入口 |
| 项目 CLAUDE.md | 提供"会话启动建议 /handoff 检查"的提示（但不依赖 AI 自扫） |
docs/handoff/README.md | handoff 协议的详细规范 |
/wrap-up（上游 SA 侧） | 上游产出 handoff 后会话收尾（对称的另一端） |
templates/handoff.md.template | handoff 文件模板 |
参考 protocols/role-taxonomy.md —— /handoff 是 SA / handoff agent → 执行层（FE / BE / QA）的协议节点。
定位: handoff 子类型 / 承载多方异步评审(architecture / ADR / 规约 / 共识文档)/ 与"任务分发"类 handoff 共享生命周期 / 但走两阶段闭环(collect / confirm)。
依赖 protocol:
protocols/async-review.md(2026-05-26 起 / Proposed / dogfood-judge: cross-family ≥ 2 project evidence)。依赖 skill(联动起 2026-05-26):
skills/extension/async-review/(由 #14 接纳触发联动起 / Stage 1 collect + Stage 2 confirm)— 详见skills/extension/async-review/SKILL.md。手工执行路径仍保留(按 protocol §两阶段闭环规约 / opt-in 哲学 / 不强制走 skill)。
handoff 文件若 kind: review / frontmatter 必含以下 3 字段:
| 字段 | 含义 | 必填 |
|---|---|---|
review_entity_id | 评审承载 entity ID(Issue / Task 编号) | ✅ |
review_doc_path | 待评审文档路径(仅引用 / 本 handoff 不修改文档) | ✅ |
review_doc_owner | 文档主导方角色(PM / SA / TL 等) — 负责依据 conclusion 落地 | ✅ |
pending/ 评审 handoff 待启动in-progress/ 评审 collect 中completed/YYYY-MM/ 评审 conclusion 已落地(review_doc_owner 已回 comment 标 commit hash)/async-review --collect [entity-id](详见 skills/extension/async-review/SKILL.md / opt-in 路径 / 手工执行按 protocol §两阶段闭环亦可)/async-review --confirm [entity-id](同上)/ 输出 conclusion.mdreview_doc_owner 负责 — 按 conclusion.md 改文档 / 回 comment 标 commit hashkind: review handoff 不带 3 个 frontmatter 字段(导致评审承载丢失)新装项目首次部署本 skill 时建议：
--recover 参数（恢复上次中断的 in-progress 任务）/install 集成（install 时自动建目录）流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。
TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。
产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。