ai-agent-setup

AI Agent Setup

Claude Code の設定ファイルを簡単に配布・セットアップできるシステムです。

📋 概要

このプロジェクトでは、Claude Code公式プラグインシステムとグローバル設定配布スクリプトを提供しています。

📌 グローバル設定のインストール: プラグインで配布できないCLAUDE.mdとhooksは install-global.sh でインストールしてください。詳細は グローバル設定 セクションを参照してください。

🔌 プラグイン配布（推奨）

Claude Code公式プラグインシステムを使用した配布方式です。

インストール方法

ステップ1: マーケットプレイスの追加

Claude Code のチャットで以下のコマンドを実行：

/plugin marketplace add sk8metalme/ai-agent-setup

既にマーケットプレイスを追加済みの場合、エラーメッセージが表示されます（問題ありません）。

ステップ2: 推奨プラグインのインストール

基本的な開発環境を整えるため、以下のプラグインをインストール：

# 推奨: 要件を深堀りして明確化（ultrathink機能）
/plugin install deep-dive@ai-agent-setup

# 推奨: 会話履歴から自動学習（繰り返しミス防止）
/plugin install guardrail-builder@ai-agent-setup

# 推奨: 開発ワークフロー統合（計画、PR、CHANGELOG）
/plugin install development-toolkit@ai-agent-setup

ステップ3: 追加プラグインのインストール（必要に応じて）

使用するツールや言語に応じて、追加のプラグインをインストール：

# Jujutsu (jj) を使用する場合
/plugin install jujutsu-workflow@ai-agent-setup

# CI/CDトラブルシューティングが必要な場合
/plugin install ci-cd-tools@ai-agent-setup

# OSSライセンス管理が必要な場合
/plugin install oss-compliance@ai-agent-setup

# バージョン監査が必要な場合
/plugin install version-audit@ai-agent-setup

# UI/UXレビューが必要な場合
/plugin install design-review@ai-agent-setup

# E2E開発計画が必要な場合
/plugin install e2e-planning@ai-agent-setup

# 学習支援クイズが必要な場合
/plugin install quizknock@ai-agent-setup

# 日次知識自動同期が必要な場合
/plugin install daily-knowledge-sync@ai-agent-setup

# 言語別プラグイン（該当する言語のみ）
/plugin install lang-java-spring@ai-agent-setup  # Java + Spring Boot
/plugin install lang-python@ai-agent-setup       # Python + FastAPI
/plugin install lang-php@ai-agent-setup          # PHP + Slim
/plugin install lang-perl@ai-agent-setup         # Perl + Mojolicious

ステップ4: インストール確認

インストールが成功したことを確認：

# インストール済みプラグインの確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins | keys'

# または、キャッシュディレクトリを確認
ls -la ~/.claude/plugins/cache/ai-agent-setup/

利用可能なプラグイン

高優先度（推奨）:

プラグイン	説明	提供機能	キーワード
deep-dive	再帰的な深堀りで要件を明確化 推測を排除し、品質・信頼性を向上	📚スキル: 1個	deep-dive, requirements, questioning, ultrathink
guardrail-builder	会話履歴から自動学習し.claude/rules/に個別ファイルで保存 1ルール1MD構造、自動読み込み、繰り返しミス防止	📚スキル: 1個	guardrail, learning, rules, memory
development-toolkit	開発ワークフロー統合（計画・PR・CHANGELOG） 日常的な開発作業の推奨ツール	📋コマンド: 6個 📚スキル: 3個 🤖エージェント: 2個 🪝フック: 2個	development, workflow, pr, changelog, planning
jujutsu-workflow	Jujutsuバージョン管理ワークフロー .jjディレクトリやjjコマンド使用時に推奨	📚スキル: 1個 📄ドキュメント: 1個	jujutsu, jj, version-control, git-alternative, vcs

中優先度（機能別）:

プラグイン	説明	提供機能	キーワード
ci-cd-tools	CI/CDトラブルシューティング・GitHub Actions支援 ビルド失敗、ワークフロー問題の診断	📚スキル: 1個	ci-cd, github-actions, troubleshooting, deployment
oss-compliance	OSSライセンスチェック・監査 ライセンス競合の検出、依存関係追跡	📚スキル: 1個 🤖エージェント: 1個	oss, license, compliance, legal, audit
version-audit	技術スタックバージョン監査・EOLチェック 古い依存関係やセキュリティ脆弱性の特定	📚スキル: 1個 🤖エージェント: 1個	version, audit, eol, security, dependencies
design-review	UI/UXデザインレビュー・アクセシビリティチェック ユーザビリティ、アクセシビリティ標準の評価	📚スキル: 1個 🤖エージェント: 1個	design, ui, ux, accessibility, a11y, review
e2e-planning	E2Eファースト開発計画・Walking Skeleton設計 エンドツーエンドの実装戦略ガイド	📚スキル: 1個 🤖エージェント: 1個	e2e, planning, walking-skeleton, architecture
quizknock	インタラクティブクイズ生成・学習支援 トピック調査、5問セット出題、統計表示、復習機能	📚スキル: 1個	quiz, learning, education, assessment, review
daily-knowledge-sync	日次会話ログから知識を自動抽出・同期 エラー解決、コーディングパターン、ドメイン知識を自動分類・GitHub同期	📚スキル: 1個	knowledge, learning, automation, daily, sync

低優先度（言語別）:

プラグイン	説明	提供機能	キーワード
lang-java-spring	Java + Spring Boot開発支援 ベストプラクティス、パターン、トラブルシューティング	📚スキル: 1個 🌐言語設定: 1個	java, spring, spring-boot, development
lang-python	Python + FastAPI開発支援 モダンなPythonパターン、非同期プログラミング、API設計	📚スキル: 1個 🌐言語設定: 1個	python, fastapi, async, development
lang-php	PHP + Slim Framework開発支援 モダンなPHP開発プラクティス、RESTful API設計	📚スキル: 1個 🌐言語設定: 1個	php, slim, framework, development
lang-perl	Perl + Mojolicious開発支援 Perlベストプラクティス、モダンなWeb開発	📚スキル: 1個 🌐言語設定: 1個	perl, mojolicious, development

更新方法

プラグインを最新バージョンに更新：

# 特定のプラグインを更新
/plugin update development-toolkit@ai-agent-setup

# すべてのプラグインを一括更新
/plugin update --all

# 更新確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins["development-toolkit@ai-agent-setup"][0].lastUpdated'

アンインストール方法

プラグインが不要になった場合：

# 特定のプラグインをアンインストール
/plugin uninstall development-toolkit@ai-agent-setup

# マーケットプレイスごと削除（すべてのプラグインが削除されます）
/plugin marketplace remove ai-agent-setup

# アンインストール確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins | keys'

🤖 スキル & エージェント