Agent skill

workflow-guide

Provides guidance on Cursor ↔ Claude Code 2-agent workflow. Use when user mentions ワークフローについて, Cursorとの連携, 作業の流れ, 2-agent workflow, collaboration. Do NOT load for: 実装作業, ワークフロー設定, ハンドオフ実行.

View SKILL.md on GitHub Repository
Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/chachamaru127/workflow-guide

Metadata

Additional technical details for this skill

skillport 
{
    "tags": [
        "workflow",
        "guide",
        "cursor",
        "collaboration"
    ],
    "category": "core",
    "alwaysApply": false
}

SKILL.md

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回連続で失敗した場合：

  1. 自動修正を中止
  2. エスカレーションレポートを生成
  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 - タスク管理ファイル

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results