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の名前が存在することを能力成立と扱わない。

Installs
17
GitHub Stars
2
First Seen
Oct 24, 2026