skill-selection
Installation
SKILL.md
Skill Selection
Skillの導入を「良さそうなものを足す」作業にしない。目的は、projectに必要な能力ごとに、衝突しない担当を1つずつ決めることである。
Skillの誘導と実行上の強制を区別する
Skillは判断と作業を支援する指示であり、遵守や品質を強制する境界ではない。実成果物の制約と受理経路は別に成立させる。「当てはまるかもしれないから使う」ものではない。
- 発火する場面が明確で、その場面にちょうど当てはまるSkillだけを採用する。少しでも関係しそうなら起動する、という広いtriggerのSkillは採らない。
- 手順の量は、防ぐ失敗の大きさに比例させる。短い作業を長い儀式に変えるSkill(小さな修正にも毎回TDDや対話式のbrainstormingを強制するもの等)は採らないか、条件を絞った起動にする。
- 良いSkillは、防ぐ失敗の型と、その場面でだけ効く判断基準を短く持つ。一般的な心得の網羅は、agentが既定でできることの繰り返しになりやすい。
project-initには、選定の材料となる2つの表がある。
catalog/capabilities.tsv— 能力の一覧。scopeがsingleの能力は担当を1つに絞り、multiは併用してよい。needed_whenはその能力が必要になる条件。catalog/candidates.tsv— 評価済みの候補記録。許可リストではない。前回までの評価結果をまとめたキャッシュであり、記録にないSkillも探索して評価してよい。
全体品質の設計・維持には system-quality を選定する。必要な参照とscriptsも配布物として確認し、Skillの名前が存在することを能力成立と扱わない。