| name | workflow-guide |
| description | Explicit helper for Cursor PM ↔ Claude Code two-agent workflow guidance. Do NOT load for: solo implementation, workflow setup, handoff execution, or general process coaching. |
| description-en | Explicit helper for Cursor PM ↔ Claude Code two-agent workflow guidance. Do NOT load for: solo implementation, workflow setup, handoff execution, or general process coaching. |
| description-ja | Cursor PM と Claude Code の2エージェント運用を説明する明示補助スキル。単独実装、ワークフロー設定、ハンドオフ実行、一般的な進め方相談には使わない。 |
| allowed-tools | ["Read"] |
| user-invocable | false |
| disable-model-invocation | true |
Workflow Guide Skill
Cursor ↔ Claude Code 2エージェントワークフローのガイダンスを提供するスキル。
トリガーフレーズ
このスキルは以下のフレーズで起動します：
- 「ワークフローについて教えて」
- 「Cursor との連携方法は？」
- 「作業の流れを教えて」
- 「どうやって進めればいい？」
- "how does the workflow work?"
- "explain 2-agent workflow"
概要
このスキルは、Cursor（PM）と Claude Code（Worker）の役割分担と連携方法を説明します。
2エージェントワークフロー
役割分担
| エージェント | 役割 | 責務 |
|---|
| Cursor | PM（プロジェクトマネージャー） | タスク割り当て、レビュー、本番デプロイ判断 |
| Claude Code | Worker（作業者） | 実装、テスト、CI修正、staging デプロイ |
ワークフロー図
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ ・タスクを Plans.md に追加 │
│ ・Claude Code に作業を依頼（/handoff-to-claude） │
│ ・完了報告をレビュー │
│ ・本番デプロイの判断 │
└─────────────────────┬───────────────────────────────────┘
│ タスク依頼
▼
┌─────────────────────────────────────────────────────────┐
│ Claude Code (Worker) │
│ ・/work でタスク実行（並列実行対応） │
│ ・実装 → テスト → コミット │
│ ・CI 失敗時は自動修正（3回まで） │
│ ・/handoff-to-cursor で完了報告 │
└─────────────────────┬───────────────────────────────────┘
│ 完了報告
▼
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ ・変更内容を確認 │
│ ・staging 動作確認 │
│ ・本番デプロイ実行（承認後） │
└─────────────────────────────────────────────────────────┘
Plans.md によるタスク管理
マーカー一覧
| マーカー | 意味 | 設定者 |
|---|
pm:依頼中 | PM から依頼（互換: cursor:依頼中） | PM（Cursor/PM Claude） |
cc:TODO | Claude Code 未着手 | どちらでも |
cc:WIP | Claude Code 作業中 | Claude Code |
cc:完了 | Claude Code 完了 | Claude Code |
pm:確認済 | PM 確認完了（互換: cursor:確認済） | PM（Cursor/PM Claude） |
cursor:依頼中 | （互換）pm:依頼中 と同義 | Cursor |
cursor:確認済 | （互換）pm:確認済 と同義 | Cursor |
blocked | ブロック中 | どちらでも |
タスクの状態遷移
pm:依頼中 → cc:WIP → cc:完了 → pm:確認済
主要コマンド
Claude Code 側
| コマンド | 用途 |
|---|
/harness-init | プロジェクトセットアップ |
/plan-with-agent | 計画・タスク分解 |
/work | タスク実行（並列実行対応） |
/handoff-to-cursor | 完了報告（Cursor PMへ） |
/sync-status | 状態確認 |
スキル（会話で自動起動）
| スキル | トリガー例 |
|---|
handoff-to-pm | 「PMに完了報告」 |
handoff-to-impl | 「実装役に渡して」 |
Cursor 側（参考）
| コマンド | 用途 |
|---|
/handoff-to-claude | Claude Code にタスク依頼 |
/review-cc-work | 完了報告のレビュー |
CI/CD ルール
Claude Code の責務範囲
- ✅ staging デプロイまで
- ✅ CI 失敗時の自動修正（3回まで）
- ❌ 本番デプロイは禁止
3回ルール
CI が 3回連続で失敗した場合：
- 自動修正を中止
- エスカレーションレポートを生成
- Cursor に判断を委ねる
よくある質問
Q: Cursor がいない場合は？
A: 一人で作業する場合も、Plans.md でタスク管理することを推奨します。
本番デプロイは手動で慎重に行ってください。
Q: タスクが不明確な場合は？
A: Cursor に確認を依頼するか、/sync-status で現状を整理してください。
Q: CI が何度も失敗する場合は？
A: 3回以上は自動修正せず、Cursor にエスカレーションしてください。
関連ドキュメント
- AGENTS.md - 詳細な役割分担
- CLAUDE.md - Claude Code 固有の設定
- Plans.md - タスク管理ファイル
