交接技能Skill handoff

交接技能用于管理产品经理(PM)与开发实现角色之间的工作交接,包括完成报告生成、代码审查自动修复、提交执行等功能,确保软件开发工作流的平滑过渡和高效协作。关键词:PM交接、代码审查、自动修复、工作流管理、软件开发、DevOps、自动化工具、CI/CD集成。

DevOps 0 次安装 0 次浏览 更新于 3/10/2026

名称: handoff 描述: “向PM的完成报告以及代理间的交接。实现平滑的过渡。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意完成声明、进度聊天、非正式状态更新。” 英文描述: “向PM的完成报告和代理交接。实现平滑过渡。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意完成声明、进度聊天、非正式状态更新。” 日文描述: “向PM的完成报告以及代理间的交接。实现平滑的过渡。当用户提及’/handoff’、完成报告、交接给Cursor/OpenCode、自动修复或向PM报告时使用。不要用于:随意完成声明、进度聊天、非正式状态更新。” 允许工具: [“读取”, “写入”, “编辑”, “Bash”, “Grep”, “Glob”] 参数提示: “[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差异和测试结果

前提条件

此命令仅在harness-review批准后运行

条件 必需 检查方法
harness-review完成 审查结果为批准
无关键/高优先级问题 全部修复
实现完成 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循环
    ├── 不通过(关键/高优先级) → 修复 → 重新审查
    └── 通过(批准) → 阶段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-代理工作流)