Workflow Guide Skill Skill

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 にエスカレーションしてください。

Agent Skills: Workflow Guide Skill

Skill Files