ref-skill-naming-convention

Purpose & Output Contract

Skill 命名規約の正本サマリ（第1〜16条）。 本SKILL.md は要約のみ。条文全文は references/articles-full.md。

Key Rules（条文サマリ）

1. 第1条 形式: kebab-case、英小文字+数字+ハイフン。
2. 第2条 prefix必須: run- / ref- / assign- / wrap- / delegate- のいずれか。
3. 第3条 role-suffix推奨: -evaluator / -generator / -runbook 等。
4. 第4条 動詞 or 名詞: run/assign系は動詞、ref/wrap/delegate系は名詞。
5. 第5条 60文字以下: prefix含む合計。
6. 第6条 予約語回避: skill, claude, anthropic 単独使用禁止。
7. 第7条 ディレクトリ名 == frontmatter.name.
8. 第8〜13条 構造: templates/, references/, scripts/, examples/ 配下のファイル命名。
9. 第14条 多言語: description は日本語推奨。動詞ベースの2〜3個のトリガー条件を含むこと（本文も日本語可）。
10. 第15条 改名は alias 経由: aliases: [old-name] で猶予期間。
11. 第16条 forbidden: test- / tmp- / wip- prefix は本番投入禁止。
12. 第17条 role-suffix 語彙: -evaluator / -generator / -linter / -auditor / -aggregator / -runbook / -watcher / -dispatcher を正式語彙とする。新設は governance board 承認が必要。詳細: references/role-suffix-vocabulary.md。

5 prefix × 4軸 対応

references/prefix-axis-matrix.md を参照。 4軸 = (発動主体, context, write権限, 評価対象)。

Steps

参照用。命名時のフロー:

1. 用途 → prefix選定（matrix 参照）
2. role-suffix を付与（第3条）
3. python3 ${HARNESS_ROOT:-.}/scripts/lint-skill-name.py SKILL.md で第1〜5,7条検証

Gotchas

• assign- は user-invocable: false が原則: 第2条 + 04章。
• ref- は disable-model-invocation: true 必須: 自動発動を防ぐ。
• 改名は破壊的変更: 第15条 alias を必ず付ける（後方互換）。

Additional Resources

• references/articles-full.md — 第1〜16条全文
• references/decision-table.md — 主要8ケース裁定表
• references/prefix-axis-matrix.md — 5 prefix × 4軸
• ../run-skill-elicit/SKILL.md#onboarding-mode初学者向け3問 — 初学者向け Onboarding mode（Q1/Q2/Q3 から prefix を自動推定）
• lint: scripts/lint-skill-name.py