init-claude-specialist
対象リポジトリに導入済みのスペシャリスト skill(specialist: true を frontmatter に持つ
skill)を検出し、1 agent 1 skill 原則で専用 sub-agent を .claude/agents/specialists/ に
生成する。ユーザーが専門領域の相談をしたとき、main が直接答えず該当 sub-agent を起動して
回答させることで main のトークン消費を抑える。
使い方
init-claude-specialist [対象リポジトリのパス]
パスを省略した場合はカレントディレクトリを対象とする。
前提条件
- 対象リポジトリで
gitが初期化済みであること - スペシャリスト skill が
npx skills add Fandhe-AI/agent-specialist-skills等で.claude/skills/または.agents/skills/へ 1 件以上導入済みであること (0 件の場合は Step 2 で「導入済みスペシャリスト skill が無い」と報告して終了する)
フロー
Step 1: 前提確認
対象リポジトリのルートで実行する。.claude/ の有無を確認し、無ければ最低限のディレクトリを
作成する。
cd <target-repo>
ls -d .claude 2>/dev/null || mkdir -p .claude/agents .claude/rules
mkdir -p .claude/agents/specialists
対象リポが dotclaude-via-temp(.claude/ 配下を _/dotclaude/ 経由で編集する)を採用している
場合は、Step 3・Step 4 の生成物をすべて _/dotclaude/ 配下に作成してから mv で配置する
(「注意事項」節参照)。
Step 2: 導入済みスペシャリスト skill の検出
.claude/skills/ と .agents/skills/ を走査し、SKILL.md の frontmatter に
specialist: true を持つスキルを列挙する。このリポ(Fandhe-AI/agent-specialist-skills)発の
スペシャリスト skill は全て specialist: true を宣言する規約であるため、この 1 キーで
判別できる。
for dir in .claude/skills .agents/skills; do
[ -d "${dir}" ] || continue
for skill_md in "${dir}"/*/SKILL.md; do
[ -f "${skill_md}" ] || continue
if awk 'NR==1{next} /^---[[:space:]]*$/{exit} /^specialist:[[:space:]]*true[[:space:]]*$/{found=1} END{exit !found}' "${skill_md}"; then
echo "${skill_md}"
fi
done
done | sort -u
検出結果が 0 件の場合は「導入済みスペシャリスト skill が無い。npx skills add Fandhe-AI/agent-specialist-skills でスペシャリスト skill を導入してから再実行する」と報告して
終了する。
Step 3: 1 agent 1 skill の sub-agent 生成
検出した各スキル <name> について .claude/agents/specialists/<name>.md を生成する。
テンプレートは sample/specialist-agent-template.md を使う。
frontmatter の決定方法:
| フィールド | 値 |
|---|---|
name |
<name>(スキルディレクトリ名と一致) |
description |
skill の description をベースに「〜について相談したい・質問したい時に起動」を明記 |
model |
skill frontmatter の specialist-model があればその値、無ければ既定 sonnet |
effort |
skill frontmatter の specialist-effort があればその値、無ければ既定 low |
tools |
Read, Glob, Grep, WebFetch, WebSearch(読み取り専用。相談用途のため編集ツールは付与しない) |
model/effort の既定値はトークン消費抑制を優先して低めに倒す。機械的・定型知識の Q&A が
中心のスペシャリスト skill は specialist-model: haiku を宣言してよい。経営・戦略判断が本質の
スペシャリスト skill のみ specialist-model: opus や specialist-effort: medium
以上を宣言する(判断基準の詳細は .claude/rules/specialist-authoring.md)。
本文には「起動されたらまず Skill ツールで <name> skill を読み込み、そのペルソナ・知識体系に
従って回答する。回答は日本語・常体。skill に無い事実は推測と明示する」という骨子を記載する。
例外: 複数 skill を束ねる 1 agent
基本は 1 agent 1 skill だが、次の両方を満たす場合に限り、密接に関連する複数 skill を 1 agent にまとめてよい。
- 同一ドメインのスペシャリスト skill 同士である(例:
game-producerとgame-monetization-analystはいずれもゲーム事業領域) - ユーザーの相談が実務上ほぼ常に両方の知識を横断する(片方だけで完結する相談が稀)
この例外を適用する場合は、生成後に agent frontmatter・本文を手動編集し、本文に束ねる全 skill の読み込み手順を列挙する。自動生成では 1 agent 1 skill を崩さない(判断が要る例外は 自動化しない)。
Step 4: 委譲 rule の生成
sample/specialist-delegation-template.md を対象リポの .claude/rules/specialist-delegation.md
に配置する。テンプレートのプレースホルダ表に、Step 3 で生成した agent 一覧
(subagent_type / 対応 skill / 相談領域)を埋め込む。
内容の骨子: 「ユーザーがスペシャリストの専門領域に該当する質問・相談をしたら、main が直接
回答せず該当 sub-agent(subagent_type: <name>)を起動して回答させる。独立した複数領域の
質問は同一メッセージ内で並列起動。main は回答の統合・報告のみ行う」。
Step 5: CLAUDE.md への反映
対象リポの CLAUDE.md に「Specialist Agents」節を追記または更新する。既存の節がある場合は
表の中身のみ差し替える(節の位置・見出しレベルは変更しない)。
## Specialist Agents
| subagent_type | model | effort | 対応 skill | 相談領域 |
|---------------|-------|--------|-----------|---------|
| <name> | <model> | <effort> | <name> | <一言説明> |
Step 6: 検証
生成した agent ファイルの frontmatter を目視確認し、件数を報告する。
ls -la .claude/agents/specialists/
find .claude/agents/specialists -name '*.md' | wc -l
既存の agent ファイルを再生成で上書きする場合は、上書き前に diff で差分を提示し、
手動カスタマイズ済み(Step 3 の例外適用等)と判断される場合はユーザーに確認してから進める。
diff -u .claude/agents/specialists/<name>.md <生成予定の新内容> || true
検証
.claude/rules/verification.md の5段階ゲートに従い、以下で完了を確認する。
# Step 2 で検出したスキル件数と Step 3 で生成した agent 件数が一致すること
# (例外で複数 skill を 1 agent に束ねた場合は agent 件数 < skill 件数になり得るため、
# 不一致が出た場合はその理由が Step 3 の例外適用によるものか確認する)
find .claude/agents/specialists -name '*.md' | wc -l
# 生成した各 agent の frontmatter に name / description / model / effort / tools が揃っていること
for f in .claude/agents/specialists/*.md; do
echo "== ${f} =="
awk 'NR==1{next} /^---[[:space:]]*$/{exit} {print}' "${f}"
done
# CLAUDE.md に Specialist Agents 節が存在すること
grep -n '^## Specialist Agents$' CLAUDE.md; echo "exit=$?"
注意事項
- 対象リポが
dotclaude-via-tempルールを採用している場合、.claude/agents/specialists/・.claude/rules/specialist-delegation.mdの作成・編集は直接書き込まず_/dotclaude/経由で 行い、完了後にmvで最終配置する(rm -rf _/dotclaudeは禁止。空になった場合のみrmdirで削除する) - 再実行は冪等に保つ: 既存 agent は対応 skill の
description/specialist-model/specialist-effortが更新されていれば再生成する。手動カスタマイズ済み(例外束ね等)と 判断される agent は上書き前に必ずユーザーへ確認する - 生成した agent には編集系ツール(
Edit・Write・Bash)を付与しない。相談用途であり 副作用のある操作を行わせないため - スペシャリスト skill 自体の新規作成は
specialist-skill-example.md(見本)と.claude/rules/specialist-authoring.md(著作規約)を参照する。本スキルは既存スキルの agent 化のみを担う - CLAUDE.md の他セクション(Overview・Repository Structure 等)は本スキルの対象外。
それらの更新は
update-docsを参照