skill-creator

Skill Creator

skill は agent が実行する制御プログラムで、書いた瞬間から常駐コスト（description は毎 セッション載る）と drift コスト（隣接 skill との二重定義）を払い始める。この skill は 「作るか」を決めない — それは著者（明示指示）か learn-eval が持つ。決めるのは形 （新規 / 既存へ統合 / 既存改修）と境界で、書いた後に fresh context で判定する。

1. 入口 — intent を 1 packet に固定する ⏸ 著者確認

会話に素材があれば先に抽出してから埋める（使ったツール、手順、著者の訂正、入出力）:

• 何をできるようにするか（1 文）
• いつ使うか — 著者の発話例を 3 つ（description にそのまま入れる。自発発火を 狙う skill のみ — 狙わないなら §3 の disable-model-invocation）
• NOT for — 隣接 skill / agent を名指しで
• 置き場 — skills/<name>/SKILL.md（commands/ は使わない）か agents/<name>.md
• 検証可能な出力か（file 変換・固定手順なら with/without を見る価値がある。文体系は不要）

隣接 skill を library 全体で grep する（name / description / NOT for 行）。重なりが 見つかったら、新規でなく既存への統合か改修に倒す判断をここでする。batch 内限定の skill-stocktake Uniqueness と違い、作成時は対象が 1 件なので全体を見られる。

2. 作成時の判断（実測から昇格した 4 つ）

判断	問い	出所
Abstraction trap	一般化しても次回の行動が変わるか。具体的な Before/After が書けないなら抽象化しすぎ	2026-03-15 ai-tool-design: 議論を経て「当たり前」に劣化
Trigger ceiling	自発発火は description を磨いても伸びない（1 件の実測。天井の数値は未確定）。user-invocable: true を既定にし、確実性が要る場面は rule の命令形か hook で配線する	2026-04-11 search-first: text 編集で 27%→8%、revert
Redundant channel	既存チャネル（CLI 出力・他 skill・rule）が運ぶ情報を複製しない。複製は観測性でなく視線分散を増やす	2026-04-12 Zed 追従 hook の棄却
Recommender 不適合	「推奨する」型の skill は成熟 harness で空振り → 暴走（新規作成を提案）する。空の出力を出せる設計か	2026-04-07 workspace-surface-audit

3. 書き方 — Fable 向け

• 判断基準と罠を書く。手順の羅列・反復強調・トリビアルな禁止列挙は書かない — 禁止は原理原則へ畳む。ただし grep 可能な検出語・自己執行力のある禁止・数値閾値は 畳まない（抽象化すると機能を失う — ADR-0058）。迷ったら generation-audit の 4 観点（意図 / 根拠 / 鮮度 / 失効条件）で各行を見る
• 現行規則として書く — 前版との差分を書かない。 「（日付 追加 / 追記 / 移設 / 移管 / 再編 / 明文化）」「Y から降格」「旧 X は廃止、no longer」「日付 に復活」は edit 履歴で、 git と ADR が持つ。本文は現在の規則 + 理由 1 句 + ADR/RFC 番号。as-of 日付は claim に だけ付ける（knowledge-staleness — 外部事実の検索時点、実測の観測日）。edit の日付は 付けない。改修時に入る型で、新規作成ゲートを通らない — harness_lint.py が同一括弧内の 日付 + edit 動詞を止める（実測: 2026-09-02 prompt-audit で 88 件中 55 件。ADR-0061）
• 存在しないものを「やらない」と書かない（tombstone）。 退役した step / store / 機構は 消し、禁止の実体があれば正の形で書く（「Wikidata 連邦 — RETIRED、この step は実行しない」 → 「sameAs は self-sovereign な解決先のみ」）。モデルは見たことのない選択肢を幻の代替 として読む
• 経緯は ADR、本文は規則。 「初見では X と推定しかけたが…」「第一波 / 第二波で移行」型の 物語は残さない。理由が 1 句で言えるなら 1 句（「正本の改名時にコピーが取り残された前例あり」）
• 改修は置換であって追記ではない。 規則を変えたら旧記述を grep して消す — 同一ファイル内に 2 版が残ると Fable は両方を文字通り読んで毎回どちらかを選ぶ（config-gc の削除手順、 authorship-strategy の型 (b) 配置で実例）
• 条件を列挙したら tie-breaker を置かない。 「判断に迷ったら Y」は条件付きに降格した gate を Y 側へ戻す（implementation-chain feat×TDD で実例）
• 例は出力の register を固定する。 例の文体・長さ・言語がそのまま出力に写る。GitHub コメント調の小文字例 9 本（thermo-nuclear）のような register 例は置かない。format を pin する例だけ、illustrative と明記して置く
• 重なる内容は参照で済ませる（正本は 1 か所。複製した版は誰も刈らず drift する）
• frontmatter: name（dir と一致）/ description（発話例 + NOT for）/ user-invocable / origin（rules/common/skills.md の表）。agent は tools / model も（判定系は opus、 read-only + Bash は evidence script がある時だけ）
• description は trigger surface で、毎セッション listing に常駐する — 字数コスト だけでなく、載っているだけで挙動に干渉しうる未監査の常駐指示層（RFC-0018）。自発発火を 狙わない skill（slash / rule の命令形 / 他 skill の参照で届くもの）は disable-model-invocation: true を既定に検討（RFC-0017）— listing から降り、 description は人間用 slash メニューにだけ残る。その場合 §1 の発話例 3 つは不要
• 上限 500 行（Anthropic 公式 best practices、as-of 2026-08-29）。超える分は references/ に 逃がす。script を持つなら pyproject.toml + tests
• 名指しする path / agent / CLI flag は書いた時点で存在させる（scan_refs が後で拾うが、 書く側で潰す方が安い）