// claude-code-best-practiceリポジトリを最新化し、現在のClaude Code設定（global / project）に対してベストプラクティスに基づく改善提案を行う。引数 global/project でスコープ指定可。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | best-practice |
| description | claude-code-best-practiceリポジトリを最新化し、現在のClaude Code設定（global / project）に対してベストプラクティスに基づく改善提案を行う。引数 global/project でスコープ指定可。 |
| when_to_use | 以下のいずれかに該当する場合に使用： - 「ベストプラクティス」「best practice」「設定見直し」「設定改善」を求められた - 「スキル改善」「Claude Code最適化」「ハック改善」を求められた - settings.json/CLAUDE.md/skills/agents/hooks の見直しや陳腐化チェックを依頼された |
| allowed-tools | Read, Bash(git pull*), Bash(git -C * pull*), Bash(ghq get*), Bash(ls *), Bash(touch *), Glob, Grep |
claude-code-best-practiceリポジトリ（https://github.com/shanraisshan/claude-code-best-practice）を参照し、現在の設定に対する改善提案を行う。
$ARGUMENTS で適用先スコープを決定する：
| 引数 | 対象 |
|---|---|
global | グローバル設定のみ（~/.claude/） |
project | 現在のプロジェクト設定のみ（.claude/、CLAUDE.md） |
| 空 or 未指定 | 両方 |
まず実行タイムスタンプを更新する（放置警告用）：
touch ~/.claude/skills/best-practice/.last-run
続いてリポジトリを最新化する：
REPO=~/ghq/github.com/shanraisshan/claude-code-best-practice
if [ -d "$REPO" ]; then
git -C "$REPO" pull --ff-only 2>&1
else
ghq get https://github.com/shanraisshan/claude-code-best-practice 2>&1
fi
pullに失敗した場合はその旨をユーザーに伝え、ローカルの既存内容で続行する。
リポジトリパス: ~/ghq/github.com/shanraisshan/claude-code-best-practice
サブエージェントを使い、以下のファイル群から現在のプロジェクトに関連する内容を読み取る。メインコンテキストを汚さないよう、読み込みと分析はサブエージェントに委譲する。
主要な参照先：
best-practice/ — 7つのコア・ベストプラクティス（subagents, commands, skills, settings, memory, mcp, cli flags）implementation/ — 各機能の実装例tips/ — Claude Code開発者からの実践的Tipsreports/ — 設定比較やワークフローの詳細分析スコープに応じて以下を読み取る：
globalスコープ（~/.claude/）：
~/.claude/CLAUDE.md — グローバル指示~/.claude/settings.json — グローバル設定~/.claude/skills/ — グローバルスキル一覧~/.claude/commands/ — グローバルコマンド（存在する場合）projectスコープ（カレントディレクトリ）：
CLAUDE.md — プロジェクト指示.claude/settings.json — プロジェクト設定.claude/settings.local.json — ローカル設定.claude/skills/ — プロジェクトスキル.claude/commands/ — プロジェクトコマンド（存在する場合）.claude/agents/ — プロジェクトエージェント（存在する場合）.claude/hooks/ — プロジェクトフック（存在する場合）ベストプラクティスと現在の設定を比較し、以下の観点で改善提案を行う：
提案は以下のフォーマットで出力する：
### [重要度: 高/中/低] 提案タイトル
**現状**: 現在の設定や状態の説明
**提案**: 具体的な変更内容
**理由**: ベストプラクティスのどの知見に基づくか
\`\`\`json or markdown
具体的な変更コード例
\`\`\`
重要度が高いものから順に提示する。