name: handoff description: “向PM的完成报告和代理间交接。实现平滑的交接。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意的完成陈述、进度聊天、非正式状态更新。” description-en: “向PM的完成报告和代理交接。实现平滑过渡。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意的完成陈述、进度聊天、非正式状态更新。” description-ja: “向PM的完成报告和代理间交接。实现平滑的交接。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意的完成陈述、进度聊天、非正式状态更新。” allowed-tools: [“Read”, “Write”, “Edit”, “Bash”, “Grep”, “Glob”] argument-hint: “[cursor|opencode|auto-fix]”
交接技能
管理PM与实现者之间的交接和工作流迁移的技能。
功能详细
| 功能 | 详细 |
|---|---|
| PM→实现者 | 参见 references/handoff-to-impl.md |
| 实现者→PM | 参见 references/handoff-to-pm.md |
| 审查指摘自动修正 | 参见 references/auto-fixing.md |
| 提交执行 | 参见 references/execute-commit.md |
快速参考
- “向Cursor写完成报告” →
/handoff cursor - “交接给OpenCode” →
/handoff opencode - “自动修正审查指摘” →
/handoff auto-fix - “包括更改内容和测试结果” → 包括git diff和测试结果
先决条件
此命令应仅在harness-review批准后运行
| 条件 | 必需 | 检查方法 |
|---|---|---|
| harness-review 完成 | 是 | 审查结果为 APPROVE |
| 无关键/高级问题 | 是 | 所有已修复 |
| 实现完成 | 是 | Plans.md任务完成 |
为什么交接需要审查批准:
- 否则PM会接收到未审查的更改
- 质量无法保证
- 破坏
/work流程(实现 → 审查 → 修复 → 批准 → 交接)
使用
/handoff cursor # 交接给 Cursor
/handoff opencode # 交接给 OpenCode
执行流程
步骤 1: 识别已完成任务
- 检查 Plans.md 复选框
- 总结已完成的工作
步骤 2: 更新 Plans.md
# 之前
- [ ] 任务名称 `pm:依頼中`
# 之后
- [x] 任务名称 `cc:完了` (YYYY-MM-DD)
步骤 3: 收集更改
git status -sb
git diff --stat
步骤 4: 检查 CI/CD(如果适用)
gh run list --limit 3
步骤 4.5: 统一内存最终确定(必须)
在完成报告之前,确定共同内存中的最终状态:
harness_mem_record_checkpoint(session_id, title, content, tags?, privacy_tags?)
harness_mem_finalize_session(session_id, summary_mode="standard")
这样可以从 Claude Code / Codex / OpenCode 的任何地方恢复同一会话。
session_id 按 $CLAUDE_SESSION_ID → .claude/state/session.json 的 .session_id 顺序获取。
harness_mem_sessions_list(project, limit=1) 的首个使用仅限于只读(恢复确认),交接时的 record_checkpoint / finalize_session 如果没有明确 session_id 则视为失败。
如果 harness_mem_finalize_session 失败,则不确认交接。
步骤 5: 生成报告
输出格式
## 完成报告
### 摘要
- (1-3行描述已完成的工作)
### 已完成任务
- **任务名称**: [任务描述]
### 更改文件
| 文件 | 更改 |
|------|---------|
| `路径/到/文件1` | [摘要] |
| `路径/到/文件2` | [摘要] |
### 验证结果
- [x] 构建成功
- [x] 测试通过
- [x] 手动验证完成
### 风险/备注
- (如果有)
### 下一步行动(针对PM)
1. [ ] [PM下一步应做什么]
2. [ ] [可选项目]
/work 集成流程
/work 执行
↓
阶段 1: 并行实现
↓
阶段 2: harness-review 循环
├── NG(关键/高级) → 修复 → 重新审查
└── OK(APPROVE) → 阶段 3
↓
阶段 3: 自动提交(如果配置)
↓
阶段 4: 此技能运行 ← 首次交接发生
/work在阶段 4 自动调用此技能。 手动运行时,始终在 harness-review 批准后进行。
目标特定备注
交接给 Cursor
- Plans.md 标记使用
cc:完了(日语) - 报告格式优化为 Cursor PM 工作流
- 包括
/review-cc-work命令的上下文
交接给 OpenCode
- 格式类似于 Cursor
- 与 OpenCode 的命令结构兼容
- 适用于多LLM开发工作流
相关技能
work- 主要实现工作流harness-review- 代码审查setup- 项目设置(包括2-代理工作流)