mcpField
A
auto-claude

auto-claude

github.com/travisjneumanエージェントワークフロー106131 回インストール1 日前に更新
リポジトリ

auto-claude について

Auto-Claudeは、既存のコードベースで明確な複数ファイルの機能を実装するマルチエージェント型コーディングスキルです。プロジェクトを分析して計画を作り、隔離されたGit worktreeで実装し、反復QAを経てレビューに渡します。

主な機能

  1. 01コードベース分析とセマンティックベースライン
  2. 02実装仕様の生成
  3. 03自律エージェントの連携
  4. 04隔離されたGit worktreeでの開発
  5. 05反復的なQA検証
  6. 06Graphitiによるコンテキスト記憶

活用シーン

  1. 01認証やAPI機能の追加
  2. 02フォームやCRUDタスクの実装
  3. 03QAサイクルによる機能の改良

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/travisjneuman/.claude --skill auto-claude

インストール後、Claude Code で/auto-claudeを入力して読み込まれたか確認します。

詳細

Auto-Claude：自律型コーディングフレームワーク

QA 検証を伴う、複雑な機能実装向けの自律型マルチエージェントシステムです。

使用するタイミング

✅ Auto-Claude の使用に適したケース：

  • 複雑度 3～4 — 明確に定義された複数ファイルにまたがる機能
  • 明確なパターンが確立されているコードベース
  • 反復的なタスク（CRUD、フォーム、API エンドポイント、認証フロー）
  • ステップごとの確認より、最後にまとめてレビューするほうがよい場合
  • QA 検証による反復的な改善が必要な機能

❌ Auto-Claude の使用に適さないケース：

  • 複雑度 1～2 — 代わりに手動で /start-task を使用してください
  • 複雑度 5 以上 — 代わりに /gsd:new-project を使用してください
  • グリーンフィールドプロジェクト（既存コードベースのパターンがない）
  • 探索・調査タスク（要件が不明確）
  • 単純なタイプミスの修正や設定の変更
  • 実装中に人間の意思決定が必要なタスク

クイックガイド：

  • 複雑度 1～2 → 手動で実装
  • 複雑度 3～4 → Auto-Claude（自律型）
  • 複雑度 5 以上 → GSD（マルチフェーズ）

主な機能

  1. コードベース分析 — 意味的なベースラインを生成
  2. 仕様書の生成 — 詳細な実装計画を作成
  3. 自律型の実装 — マルチエージェントによる連携
  4. Git ワークツリーによる分離 — 独立したワークツリーで安全に開発
  5. QA 検証 — 反復的な品質チェック
  6. メモリーシステム — Graphiti によるコンテキストの保持

ワークフロー

# From project directory:
/auto-claude Add user authentication with JWT tokens

実行内容：

  1. プロジェクト構造を分析 → ベースラインを生成
  2. 実装仕様書を作成 → ~/.auto-claude/specs/ に保存
  3. Git ワークツリーを作成 → 分離された開発環境を用意
  4. 自律型エージェントが QA ループを通じて実装
  5. 完成したコードを返す → レビュー可能な状態

出力先： ~/.auto-claude/（gitignore 対象）

既存ワークフローとの統合

手動での実装：

/start-task [description]  → Claude implements step-by-step

自律型の実装：

/auto-claude [description] → Auto-Claude implements autonomously

マルチフェーズプロジェクト：

/gsd:new-project          → GSD for project management

設定

場所： ~/.auto-claude/.env

必須：

  • CLAUDE_CODE_OAUTH_TOKEN — Claude Code の /settings から取得します

任意（推奨）：

  • GRAPHITI_ENABLED=true — 意味的メモリー
  • GOOGLE_API_KEY — Gemini の埋め込み（メモリー機能）用
  • 代替手段：Ollama（ローカル）を使用するか、メモリーを無効にします

トレードオフ

長所：

  • 最小限の監督で自律的に動作
  • QA 検証により品質を確保
  • Git ワークツリーによってメインブランチへの影響を防止
  • メモリーが以前のセッションから学習

制限事項：

  • 確立されたコードベースに最適
  • 明確な仕様が必要
  • マルチエージェントの反復にトークンを使用
  • 完了後に手動でのマージが必要

例

適したユースケース：

  • 「JWT トークンとセッション管理を使用したユーザー認証を追加する」
  • 「localStorage への保存に対応したダークモード切り替えを実装する」
  • 「コールバックの代わりに async/await を使うよう API レイヤーをリファクタリングする」
  • 「ユーザー一覧に 1 ページあたり 20 件のページネーションを追加する」
  • 「レポートの CSV エクスポート機能を作成する」

適さないユースケース：

  • 「README のタイプミスを修正する」（簡単すぎる）
  • 「状態管理に最適な方法を調査する」（探索的）
  • 「EC プラットフォーム全体を構築する」（規模が大きすぎるため、GSD を使用）
  • 「アプリをもっとよくする」（曖昧すぎる）

一般的な所要時間

  • 分析： 30 秒
  • 仕様書の生成： 1～2 分
  • 実装： 5～15 分（複雑さによって異なります）
  • QA 検証： 2～5 分
  • レビュー： 5～10 分

合計： 多くの機能で 15～30 分

関連項目

  • generic-feature-developer — 手動実装のパターン
  • debug-systematic — 体系的なデバッグ
  • test-specialist — テスト戦略

ドキュメント

~/.claude/docs/AUTO-CLAUDE-GUIDE.md を参照してください。以下の内容が記載されています。

  • セットアップ手順の全容
  • 詳細な手順を含む実例
  • トラブルシューティングガイド
  • パフォーマンスに関するヒント
  • 他のワークフローとの比較

コメント

Markdown 対応