claude-code-guide

Claude Code ガイド

目的

Claude Code（エージェント型コーディングツール）を最大限に活用するための、設定と使用方法に関する包括的なリファレンスを提供します。このスキルでは、ベストプラクティス、設定テンプレート、高度な使用パターンをまとめています。

設定（CLAUDE.md）

まず既存のプロジェクト指示を確認してください。リクエストされた範囲内でのみ、リポジトリの規約と既存の指示を維持しながら、プロジェクトの CLAUDE.md を追加または更新してください。以下のテンプレートは React／TypeScript の npm プロジェクトを例にしています。コマンドとスタックに関するルールは、確認済みのプロジェクト情報に置き換えてください。

テンプレート（一般）

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

高度な機能

思考キーワード

求める調査内容と検証基準を明示してください。以下のフレーズはタスクの内容を示すものであり、モデルの推論にかける労力を切り替える機能が保証されるわけではありません。

• 「段階を追って考えてください」
• 「根本原因を分析してください」
• 「実行前に計画を立ててください」
• 「前提を検証してください」

デバッグ

エージェントが行き詰まったり、予期しない動作をしたりした場合：

1. コンテキストをクリアする：新しいセッションを開始する前に、タスクの状態と関連する証拠を保存してください。指示を忘れるよう求めるプロンプトを送っても、読み込み済みのプロジェクトルールは消去されません。
2. 明示的に指示する：パス、ファイル名、期待する結果をできるだけ具体的に指定してください。
3. ログ：「ログを確認して」または「詳細な出力を指定してコマンドを実行して」とエージェントに依頼してください。

ベストプラクティス

1. コンテキストを小さく保つ：コードベース全体をコンテキストに詰め込まないでください。まず rg または rg --files を使って関連ファイルを特定してください。
2. 反復的に開発する：小さな変更を依頼し、検証してから次に進んでください。
3. フィードバックループ：エージェントが間違えた場合は、すぐに訂正し、（対応している場合は）その教訓をメモリまたは CLAUDE.md に追加するよう依頼してください。

検証

生成された差分を確認し、意図した指示がインストール済みのホストで実際に読み込まれていることを確かめてください。プロジェクト指示は動作を導くものであり、セキュリティ境界を強制するものではありません。追跡対象の指示ファイルに秘密情報を含めないでください。現在の機能については、公式メモリドキュメントで確認してください。

参考資料

zebbern による Claude Code Guideに基づいています。

使用する場面

プロジェクト指示の設定、Claude Code の指示の競合の診断、または検証済みのビルド／テストワークフローの定義に使用してください。

制限事項

• 上記の説明にある範囲にタスクが明確に該当する場合に限り、このスキルを使用してください。
• 出力を、環境に応じた検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。