claude-dev-skill

claude-dev-skillとは？

claude-dev-skillはClaude Codeのカスタムスキルで、Claudeを複数AIワーカーを用いたソフトウェア構築の「テックリード」プロセスに変えます。このスキルは、独立したworktreeで並行作業を調整する構造化された多段階ワークフローを提供し、PR経由で変更をルーティングすることでコンテキスト喪失やマージコンフリクトを減らします。

主な目的はシングルスレッドのコード生成を超えること：要件調整（PRD）、アーキテクチャ決定、タスク分解、並行実装、静的QAチェック、構造化されたPRレビュー/マージステップをガイドします。

主な機能

• /devコマンドワークフロー（多段階SOP）：リクエスト分類から開始し、PRD調整、アーキテクチャとIssue作成、ワーカー実装、QA検証、PRマージ調整まで実行。
• テックリードルーティングルール：メインチャットはコーディネーターとして扱われ、「直接コードを書かず」、Worker Agent → PR → レビュープロセスを経由。
• worktreeによる並行Worker Agents：機能の異なる部分（例：auth、API、frontend）をサポートするため、独立したworktreeで複数ワーカーを並行起動。
• コーディング前コンフリクトスキャン：作業前にワーカーがオープンIssueをファイル重複でスキャンし、早期にコンフリクト検知。
• マージ後PR調整：マージ後、オープンPRをスキャンし、リベースが必要なブランチを通知。
• レビュー前のセキュリティゲート：レビュー前にセキュリティツール（例：Python向けbandit＋pip-audit、Node向けnpm audit）の実行を必須化。
• 拒否条件付き構造化PRレビューChecklist：7項目のチェックリストでコードレビューを実施、必須拒否条件あり。
• テストカバレッジのためのカウンター例セルフチェック：Null/Empty/Boundary/External failure/Concurrency/Malicious inputの6カテゴリセルフチェックでワーカーの考慮を確保。

claude-dev-skillの使い方

1. スキルファイルをClaude Codeのcommandsディレクトリにインストール（macOS/Linux/Windows向けスクリプトインストール、またはディレクトリ構造を保持して手動コピー）。
2. Claude Code (Anthropic公式CLI) がログイン済みであることを確認。
3. GitHub CLI (gh) を認証セッションで使用（最初にgh auth loginを実行）。
4. Claude Codeで**/dev [オプションの説明]** を実行。スキルがリクエストを分類（例：新プロジェクト、新機能、バグ修正、ホットフィックス、アーキテクチャ変更、リファクタリング）し、適切なフローを開始。

典型的な実行はリポジトリのフェーズに従う：PRD調整（2ラウンド）、アーキテクチャとタスク分解（GitHub Issues）、並行worktreeでのワーカー実行、QA静的検証、チェックリスト駆動のPRレビューとマージ。

ユースケース

• 既存PRDを使った小〜中規模ウェブバックエンド機能構築：/devで製品要件文書をアーキテクチャ決定、GitHub Issues、並行ワーカー実装に変換。
• マージコンフリクトを最小化しつつ複数モジュール同時実装：別ワーカーが異なるコンポーネント（例：認証 vs. タスクCRUD API vs. フロントエンド）を担当し、コーディング前スキャンとマージ後リベース調整に依存。
• 調整されたバグ修正やホットフィックス作業：バグ修正や緊急ホットフィックスで、リクエストタイプを分類し、アーキテクチャレビュー、ワーカー変更、QA検証、構造化PRマージにルーティング。
• 構造化レビュー付き体系的リファクタリング：リファクタリング時、SOPのカウンター例セルフチェックとマージ前セキュリティゲートでエッジケース考慮と必須監査ツール実行を確保。
• コーディング前に調整が必要なアーキテクチャ変更作業：Phase 1のPRD調整とPhase 2のアーキテクチャ決定で、ワーカー実装前にチーム計画を明確化。

FAQ

• このスキルのワークフローにおける「tech lead」とは？ メイン会話がコーディネーターとして機能：PRDのすり合わせ、設計方向の決定、ワーカーエージェントの生成、コード変更をチャット直書きではなくWorker AgentのPRとレビュー経由で流すことを強制。

• claude-dev-skillはメイン会話から直接コードを書きますか？ いいえ。ワークフローには「鉄の掟」があり、メイン会話は直接コードを書かず、変更はWorker Agent経由でPRレビューへ。

• 並行開発時の競合はどう処理されますか？ コーディング前に競合スキャン（ワーカーエージェントがオープンIssueでファイル重複確認）、マージ後にオープンPRをスキャンしてリベースが必要なブランチを特定。

• どのようなセキュリティチェックが強制されますか？ レビュー前にセキュリティツール実行を義務付け：Pythonならbandit＋pip-audit、Nodeならnpm audit（リポジトリのSecurity gate説明による）。

• 本番デプロイ向けですか？ リポジトリのスコープでnot suited for projects requiring production deploymentと明記。DevOps/デプロイ機能なしのため。

代替案

• シングルエージェントコードアシスタント（オートコンプリート/チャット形式）：プロンプトから直接コード執筆に特化するが、マルチエージェントのPRD-to-PRワークフローや強制レビューゲートは通常提供なし。
• 従来のマルチステッププロンプト＋手動PRワークフロー：Claudeにタスク分解を促し手動でワーカー実行可能だが、ビルトインSOP構造（分類、競合スキャン、QA/チェックリストレビュー連携）が失われる。
• 標準GitHub駆動チームワークフロー（AI SOPなしのIssues/PRs）：GitHub Issues/PRレビューでフローの一部再現可能だが、「ワーカーエージェント」の並列化や自動フェーズルーティングは同等に提供されない。
• 企画やテスト特化の他のClaude Codeカスタムスキル：エンドツーエンドの並列ワーカー連携ではなく、ワークフローの一部（例: テスト生成）のみ対象とし、統合/マージ連携をユーザーに委ねる。