クイックスタートガイド

5分でAI指示書キットをプロジェクトに導入しましょう!

📋 前提条件

🚀 ステップ1: リポジトリを取得

# AI指示書キットをクローン
git clone https://github.com/dobachi/AI_Instruction_Kits.git
cd AI_Instruction_Kits

🔧 ステップ2: プロジェクトにセットアップ

あなたのプロジェクトのルートディレクトリで実行:

# 対話形式でセットアップ(推奨)
bash path/to/AI_Instruction_Kits/scripts/setup-project.sh

セットアップモードを選択

画面に表示される3つのモードから選択:

🎯 AI指示書の統合モードを選択してください:

1) copy      - シンプルなファイルコピー(Gitなし)
2) clone     - 独立したGitリポジトリ(自由に変更可能)
3) submodule - Gitサブモジュール(推奨)

選択してください [1-3] (デフォルト: 3): 

📝 ステップ3: プロジェクト設定をカスタマイズ

生成された instructions/PROJECT.md を編集:

## プロジェクト固有の追加指示

### 例:
- コーディング規約: ESLint設定に従う
- テストフレームワーク: Jest
- ビルドコマンド: npm run build
- リントコマンド: npm run lint
- その他の制約事項: TypeScript strict mode

💬 ステップ4: AIに指示を出す

Claude の場合

# プロジェクト設定を読み込んで作業開始
claude "CLAUDE.mdを参照して、ユーザー認証APIを実装して"

ChatGPT の場合

# ファイルをアップロードまたはコピー&ペースト
"CLAUDE.mdの内容に従って、データベーススキーマを設計して"

Gemini の場合

# ファイルをアップロードまたはコピー&ペースト
"GEMINI.mdの内容に従って、データベーススキーマを設計して"

🎯 実践例

例1: Reactコンポーネント作成

claude "CLAUDE.mdを参照して、商品一覧を表示するReactコンポーネントを作成。
- Material-UIを使用
- ページネーション機能付き
- 検索機能付き"

例2: API設計

claude "CLAUDE.mdを参照して、RESTful APIを設計。
エンドポイント:
- ユーザー管理 (CRUD)
- 認証(JWT使用)
- ファイルアップロード"

⚡ 高度な使い方

カスタムリポジトリを使用

# フォークしたリポジトリを使用
bash setup-project.sh --url https://github.com/yourname/AI_Instruction_Kits.git --clone

# プライベートリポジトリを使用
bash setup-project.sh --url git@github.com:company/private-instructions.git --submodule

CI/CDでの自動セットアップ

# 確認プロンプトなしで実行
bash setup-project.sh --submodule --force

📊 進捗管理

チェックポイント機能が自動的に作業を記録:

# 進捗ログを確認
cat checkpoint.log

# 出力例:
[2024-01-05 10:00:00][TASK-abc123][START] ユーザー認証API実装 (推定5ステップ)
[2024-01-05 10:30:00][TASK-abc123][COMPLETE] 成果: API 3エンドポイント、テスト15個作成

❓ よくある質問

Q: 既存のプロジェクトに影響はありますか?

A: 最小限の影響で導入できます。追加されるのは:

Q: 指示書は日本語のみですか?

A: 日本語と英語の両方に対応しています。PROJECT.en.mdを編集すれば英語版も利用できます。

Q: カスタマイズは可能ですか?

A: はい!各指示書は自由に編集でき、新しい指示書の追加も簡単です。

🎉 セットアップ完了!

これでAI指示書キットの導入は完了です。 効率的なAI活用をお楽しみください!

🚀 次のステップ