交接技能Skill handoff

交接技能是一个用于管理软件开发中项目管理(PM)与实现者之间工作交接的工具。它涵盖完成报告生成、代码审查自动修复、CI/CD集成以及统一内存管理,确保平滑过渡和质量控制。关键词:交接、项目管理、代码审查、自动修复、DevOps、软件开发流程、工作流管理。

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

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-代理工作流)