Handoff Skill
PM-実装役間のハンドオフとワークフロー遷移を管理するスキル。
機能詳細
機能 詳細
PM→実装役 See references/handoff-to-impl.md
実装役→PM See references/handoff-to-pm.md
レビュー指摘自動修正 See references/auto-fixing.md
コミット実行 See references/execute-commit.md
Quick Reference
-
"Cursor に完了報告を書いて" → /handoff cursor
-
"OpenCode にハンドオフ" → /handoff opencode
-
"レビュー指摘を自動修正" → /handoff auto-fix
-
"変更内容とテスト結果を含めて" → Includes git diff and test results
Prerequisites
This command should only run after harness-review APPROVE
Condition Required Check Method
harness-review completed Yes Review result is APPROVE
No Critical/High issues Yes All fixed
Implementation complete Yes Plans.md tasks completed
Why handoff requires review approval:
-
PM receives unreviewed changes otherwise
-
Quality not assured
-
Breaks /work flow (implement → review → fix → OK → handoff)
Usage
/handoff cursor # Handoff to Cursor /handoff opencode # Handoff to OpenCode
Execution Flow
Step 1: Identify Completed Tasks
-
Check Plans.md checkboxes
-
Summarize work done
Step 2: Update Plans.md
Before
- Task name
pm:依頼中
After
- Task name
cc:完了(YYYY-MM-DD)
Step 3: Gather Changes
git status -sb git diff --stat
Step 4: Check CI/CD (if applicable)
gh run list --limit 3
Step 4.5: Unified Memory Finalize（必須）
完了報告の前に、共通メモリへ最終状態を確定する:
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) の先頭利用は read-only（resume確認）に限定し、handoff時の record_checkpoint / finalize_session では明示 session_id が無い場合に失敗扱いとする。 harness_mem_finalize_session が失敗している場合は handoff を確定しない。
Step 5: Generate Report
Output Format
Completion Report
Summary
- (1-3 lines describing what was done)
Completed Tasks
- Task Name: [Task description]
Changed Files
| File | Changes |
|---|---|
path/to/file1 | [Summary] |
path/to/file2 | [Summary] |
Verification Results
- Build success
- Tests passed
- Manual verification complete
Risks / Notes
- (If any)
Next Actions (for PM)
- [What PM should do next]
- [Optional items]
/work Integration Flow
/work execution ↓ Phase 1: Parallel implementation ↓ Phase 2: harness-review loop ├── NG (Critical/High) → Fix → Re-review └── OK (APPROVE) → Phase 3 ↓ Phase 3: Auto-commit (if configured) ↓ Phase 4: This skill runs ← First time handoff happens
/work automatically calls this skill in Phase 4. When running manually, always do so after harness-review APPROVE.
Target-Specific Notes
Handoff to Cursor
-
Plans.md markers use cc:完了 (Japanese)
-
Report format optimized for Cursor PM workflow
-
Includes context for /review-cc-work command
Handoff to OpenCode
-
Similar format to Cursor
-
Compatible with OpenCode's command structure
-
Works with multi-LLM development workflow
Related Skills
-
work
-
Main implementation workflow
-
harness-review
-
Code review
-
setup
-
Project setup (includes 2-Agent workflow)