ccw-help

CCW-Help スキル

CCW コマンドのヘルプシステムです。コマンドの検索やおすすめ、ドキュメントの確認、Skill／Team の閲覧機能を提供します。

トリガー条件

• キーワード: "ccw-help", "ccw-issue", "ヘルプ", "コマンド", "使い方", "ccw の使い方", "ワークフロー", "skill", "team"
• シナリオ: コマンドの使い方を尋ねる、コマンドを検索する、次のステップの提案を求める、タスクにどのワークフローを使うべきか尋ねる、Skill／Team ディレクトリを閲覧する

操作モード

モード 1: コマンド検索

トリガー: "コマンドを検索", "find command", "search"

プロセス:

1. command.json の commands 配列を検索します
2. 名前、説明、カテゴリで絞り込みます
3. 関連性の高いコマンドを上位 3～5 件提示します

モード 2: スマートなおすすめ

トリガー: "次のステップ", "what's next", "おすすめ"

プロセス:

1. command.json 内のコマンドの flow.next_steps を検索します
2. 各おすすめが適している理由を説明します

モード 3: ドキュメント

トリガー: "使い方", "how to use", "詳細"

プロセス:

1. command.json でコマンドを探します
2. source パスを使ってソースファイルを読み込みます
3. 状況に応じた例を提示します

モード 4: 初心者向けガイド

トリガー: "初心者", "getting started", "よく使うコマンド"

プロセス:

1. essential_commands 配列を検索します
2. 適切なワークフローの開始地点を案内します

モード 5: CCW コマンドのオーケストレーション

トリガー: "ccw ", "自動ワークフロー", "ワークフローを自動選択", "計画を立てて"

プロセス:

1. ユーザーの意図（タスクの種類、複雑さ、明確さ）を分析します
2. ワークフローレベル（1～4 または Issue）を自動選択します
3. ワークフローに基づいてコマンドチェーンを構築します
4. ユーザーの確認を得ます
5. TODO を追跡しながらチェーンを実行します

対応ワークフロー（ccw.md を参照）:

• レベル 1 (Lite-Lite-Lite): 非常に簡単なクイックタスク
• レベル 2 (Rapid/Hotfix): バグ修正、簡単な機能、ドキュメント
• レベル 2.5 (Rapid-to-Issue): クイックプランニングから Issue ワークフローへの橋渡し
• レベル 3 (Coupled): 計画、実行、レビュー、テストを伴う複雑な機能
• レベル 3 のバリエーション:
  • TDD ワークフロー（テストファースト開発）
  • テスト修正ワークフロー（失敗するテストのデバッグ）
  • レビューワークフロー（コードレビューと修正）
  • UI デザインワークフロー
  • 複数 CLI による共同ワークフロー
  • サイクルワークフロー（統合テスト、リファクタリング）
• レベル 4 (Full): ブレインストーミングを伴う探索的タスク
• ファイル併用ワークフロー: 複数 CLI の連携による、ドキュメント化された探索
  • brainstorm-with-file: 複数の視点によるアイデア出し → workflow-plan → workflow-execute
  • debug-with-file: 仮説主導のデバッグ（単独）
  • analyze-with-file: 共同分析 → workflow-lite-plan
  • collaborative-plan-with-file: 複数エージェントによる計画 → unified-execute
  • roadmap-with-file: 戦略的な要件ロードマップ → team-planex
• Issue ワークフロー: Issue の一括発見、計画、キューイング、実行
• Team ワークフロー: 並列実行のための team-planex ウェーブパイプライン

モード 6: Issue の報告

トリガー: "ccw-issue", "バグを報告"

プロセス:

1. AskUserQuestion を使って状況を収集します
2. 構造化された Issue テンプレートを生成します

モード 7: Skill と Team の閲覧

トリガー: "skill", "team", "スキル", "チーム", "利用可能な skill", "team の使い方"

プロセス:

1. command.json の skills 配列を検索します
2. カテゴリで絞り込みます: workflow / team / review / meta / utility / standalone
3. 説明付きのカテゴリ別スキル一覧を提示します
4. team スキルについては、team のアーキテクチャと利用パターンを説明します

データソース

信頼できる唯一の情報源: command.json

フィールド	用途
commands[]	メタデータ付きのフラットなコマンド一覧
commands[].flow	関係性（next_steps、前提条件）
agents[]	エージェントディレクトリ
skills[]	カテゴリ付きの Skill ディレクトリ
skills[].is_team	スキルが team アーキテクチャを使うかどうか
essential_commands[]	主要コマンド一覧

ソースパス形式

source フィールドは相対パスです（skills/ccw-help/ ディレクトリからの相対パス）:

{
  "name": "lite-plan",
  "source": "../../../commands/workflow/lite-plan.md"
}

スキルカタログ

ワークフロースキル（コアワークフロー）

スキル	内部パイプライン	トリガー語
workflow-lite-plan	explore → plan → confirm → execute	"lite-plan"、クイックタスク
workflow-plan	session → context → convention → gen → verify	"workflow-plan"、正式な計画
workflow-execute	session discovery → task processing → commit	"workflow-execute"、実行
workflow-tdd-plan	6-phase TDD plan → verify	"tdd-plan"、TDD 開発
workflow-test-fix	session → context → analysis → gen → cycle	"test-fix"、テスト修正
workflow-multi-cli-plan	ACE context → CLI discussion → plan → execute	"multi-cli"、複数 CLI の連携
workflow-skill-designer	ワークフロースキルを設計するメタスキル	"skill-designer"

チームスキル（チーム連携）

チームスキルは team-worker エージェントのアーキテクチャを使用します。Coordinator がパイプラインを調整し、Workers は role-spec を読み込んだ team-worker エージェントです。

スキル	用途	アーキテクチャ
team-planex	計画と実行の wave パイプライン	planner + executor、明確な issue／roadmap に適しています
team-lifecycle	ライフサイクル全体（spec/impl/test）	role-specs を持つ team-worker エージェント
team-lifecycle-v4	最適化版ライフサイクル	最適化されたパイプライン
team-lifecycle-v3	基本版ライフサイクル	すべてのロールが統合スキルを呼び出します
team-coordinate	汎用の動的チーム調整	実行時に role-specs を動的に生成します
team-coordinate	汎用チーム調整 v1	動的なロール生成
team-brainstorm	チームでのブレインストーミング	複数の視点による分析
team-frontend	フロントエンド開発チーム	フロントエンドのスペシャリスト
team-issue	Issue 解決チーム	Issue 解決パイプライン
team-iterdev	反復開発チーム	反復開発
team-review	コードスキャン／脆弱性レビュー	スキャン＋脆弱性レビュー
team-roadmap-dev	Roadmap 主導の開発	要件 → 実装
team-tech-debt	技術的負債の解消	負債の特定＋解消
team-testing	テストチーム	テストの計画＋実行
team-quality-assurance	QA チーム	品質保証パイプライン
team-uidesign	UI デザインチーム	デザインシステム＋プロトタイピング
team-ultra-analyze	高度な共同分析	詳細な共同分析
team-executor	軽量実行（セッションの再開）	既存セッションの再開
team-executor	軽量実行 v2	セッション再開の改善版

スタンドアロンスキル（独立スキル）

スキル	用途
brainstorm	2 つのモードによるブレインストーミング（自動パイプライン／単一ロール）
review-code	多角的なコードレビュー
review-cycle	レビューと自動修正の調整
spec-generator	6 段階の仕様書作成チェーン（product-brief → PRD → architecture → epics）
issue-manage	対話型 Issue 管理（CRUD）
memory-capture	統合メモリキャプチャ（セッションの compact／クイックヒント）
memory-manage	統合メモリ管理（CLAUDE.md + documentation）
command-generator	コマンドファイル生成ツール
skill-generator	メタスキル：新しい Skill の作成
skill-tuning	Skill の診断と最適化

ワークフローの対応付け（CCW 自動ルーティング）

CCW はタスクの意図に応じてワークフローのレベルを自動選択します（ccw.md を参照）。

入力例	種類	レベル	パイプライン
"Add API endpoint"	feature (low)	2	workflow-lite-plan → workflow-test-fix
"Fix login timeout"	bugfix	2	workflow-lite-plan → workflow-test-fix
"共同分析：認証アーキテクチャ"	analyze-file	3	analyze-with-file → workflow-lite-plan
"auth モジュールをリファクタリング"	refactor	3	workflow:refactor-cycle
"multi-cli：API 設計"	multi-cli	3	workflow-multi-cli-plan → workflow-test-fix
"ブレインストーミング：通知システム"	brainstorm	4	brainstorm-with-file → workflow-plan → workflow-execute
"roadmap：OAuth + 2FA"	roadmap	4	roadmap-with-file → team-planex
"specification：ユーザーシステム"	spec-driven	4	spec-generator → workflow-plan → workflow-execute
"team planex：ユーザーシステム"	team-planex	Team	team-planex

スラッシュコマンド

/ccw "task description"          # Auto-select workflow and execute
/ccw-help                        # General help entry
/ccw-help search <keyword>       # Search commands
/ccw-help next <command>         # Get next step suggestions
/ccw-help skills                 # Browse skill catalog
/ccw-help teams                  # Browse team skills
/ccw-issue                       # Issue reporting

CCW コマンドの例

/ccw "Add user authentication"          # → auto-select level 2-3
/ccw "Fix memory leak in WebSocket"     # → auto-select bugfix workflow
/ccw "Implement with TDD"               # → detect TDD, use tdd-plan → execute → tdd-verify
/ccw "头脑风暴: 用户通知系统"          # → detect brainstorm, use brainstorm-with-file
/ccw "深度调试: 系统随机崩溃"          # → detect debug-file, use debug-with-file
/ccw "协作分析: 认证架构设计"          # → detect analyze-file, use analyze-with-file
/ccw "roadmap: OAuth + 2FA 路线图"     # → roadmap-with-file → team-planex
/ccw "集成测试: 支付流程"              # → integration-test-cycle
/ccw "重构 auth 模块"                  # → refactor-cycle

メンテナンス

更新メカニズム

CCW-Help スキルは、ユーザー確認ダイアログを通じた手動更新に対応しています。 スクリプトは commands/、agents/、skills/ ディレクトリをスキャンし、すべてのインデックスを再生成します。

更新方法

オプション 1：スキルの実行時にユーザーに確認が表示されます：

Would you like to update CCW-Help command index?
- Yes: Run auto-update and regenerate command.json
- No: Use current index

オプション 2：手動で更新

cd D:/Claude_dms3/.claude/skills/ccw-help
python scripts/auto-update.py

これにより analyze_commands.py が実行され、commands/、agents/、skills/ ディレクトリをスキャンして、command.json とすべてのインデックスファイルを再生成します。

更新スクリプト

• auto-update.py: analyze_commands.py を実行するシンプルなラッパー
• analyze_commands.py: ディレクトリをスキャンし、コマンド／エージェント／スキルのインデックスを生成します

生成されるインデックスファイル

ファイル	内容
command.json	マスターインデックス: コマンド + エージェント + スキル
index/all-commands.json	フラットなコマンド一覧
index/all-agents.json	エージェントディレクトリ
index/all-skills.json	メタデータ付きのスキルディレクトリ
index/skills-by-category.json	カテゴリ別にグループ化されたスキル
index/by-category.json	カテゴリ別のコマンド
index/by-use-case.json	利用シナリオ別のコマンド
index/essential-commands.json	オンボーディング向けのコアコマンド
index/command-relationships.json	コマンドフローの関係性

統計

• コマンド: 50+
• エージェント: 22
• スキル: 36+（ワークフロー 7、チーム 19、スタンドアロン／ユーティリティ 10+）
• ワークフロー: 6 つのメインレベル + 5 つのファイル付きバリアント + 2 つのサイクルバリアント
• 必須: 10 個のコアコマンド

中核原則

智能整合，非模板复制

• ユーザーの具体的な状況を理解する
• 複数のソースからの情報を統合する
• 例と説明をカスタマイズする