Claude Code機能調査ガイド

新機能調査・提案時のチェックリストと設計方針確認ガイド。

機能一覧

カテゴリ	機能	場所	実行方式	用途
メモリ	CLAUDE.md	ルート（`.claude/`も可）	自動適用	プロジェクト指示
機能拡張	Skills	`.claude/skills/`	自動発見	文脈に応じた能力
機能拡張	Slash Commands	`.claude/commands/`	手動 `/cmd`	クイック操作
機能拡張	Subagents	`.claude/agents/`	自動+手動	専門化エージェント
イベント	Hooks	`.claude/settings.json`	自動トリガー	検証・フォーマット
外部連携	MCP	Claudeアプリ側設定	ツール拡張	外部API連携

本プロジェクトの設計方針

自動実行優先

•推奨: Skills、Hooks（自動で発動）
•非推奨: Slash Commands、手動Subagents（ユーザー介入が必要）

現在使用中の機能

機能	使用状況
Skills	`development-workflow`, `code-review`, `reflection-guide`, `coding-standards`, `hooks-reference`
Hooks	多数設定済み（詳細は `hooks-reference` Skill参照）
Slash Commands	`/reflect`（振り返り実行）
Subagents	未使用

新機能提案時のチェックリスト

1. 設計方針確認

• プロジェクトは「自動実行」方針か「手動実行」方針か？
• 既存の Skills/Hooks の設計パターンを確認したか？
• 提案する機能はその方針に適合するか？

2. 機能選択ガイド

code

Q: ユーザーが明示的に呼び出す必要があるか？
├─ はい → Slash Command（本プロジェクトでは非推奨）
└─ いいえ
    Q: イベント駆動で自動実行するか？
    ├─ はい → Hook
    └─ いいえ → Skill（コンテキストに応じて自動発見）

3. 実装前確認

• 既存機能で代替できないか確認したか？
• 責務の重複がないか確認したか？
• 必要最小限の実装になっているか？

各機能の詳細

Skills（推奨）

用途: 文脈に応じて自動で発見・使用される能力

構造:

code

.claude/skills/my-skill/
├── SKILL.md (必須)
├── reference.md (オプション)
└── examples/ (オプション)

SKILL.md形式:

yaml

---
name: skill-name
description: いつ使うか、何ができるか（発見に重要）
---

# スキル名

詳細な説明とガイダンス

ポイント:

•description は具体的に（発見精度に影響）
•単一責任：1 Skill = 1 責務

Hooks（推奨）

用途: イベント駆動の自動検証・フォーマット

設定: .claude/settings.json

主要イベント:

•PreToolUse: ツール実行前（ブロック可能）
•PostToolUse: ツール実行後（検証・記録）
•Stop: レスポンス完了時（評価・クリーンアップ）

ポイント:

•単一責任：1 Hook = 1 責務
•既存Hooksとの責務重複を避ける
•詳細は hooks-reference Skill参照

Slash Commands（限定的使用）

用途: ユーザーが /command で明示的に呼び出す操作

本プロジェクトでの使用:

•基本方針は「自動実行」のため、新規追加は慎重に
•/reflect: 振り返りの明示的実行（意図的なタイミングで使用するため例外）

追加基準: ユーザーが「今このタイミングで」明示的に実行したい操作のみ

Subagents（限定的使用）

用途: 専門化されたサブタスクの委譲