プロジェクト固有スキルは汎用スキルに委譲し「毎回引っかかる固有知識・戦略」だけ残す
ドキュメント
AI協働
スキル設計
判断
原則
汎用ツールに既存の汎用スキルがあるとき、そのツールをプロジェクトで使うためのプロジェクト固有スキルには、コマンド・語彙・書き方といった汎用的な使い方を載せない。それらは汎用スキル側を参照させ、固有スキルには「このプロジェクトで使う/撮るたびに毎回引っかかる固有の罠」と戦略レベルの判断だけを残す。
除外する典型:
- バージョン番号・既存シナリオ/ファイル一覧のような、すぐ陳腐化する前提情報
- 個別画面の具体セレクタやパラメータのような、現物(シナリオ/設定ファイル・手順記録)を見れば分かるもの。スキルには戦略だけ書き、「現物を ls して見ろ」と誘導する
- 汎用スキルが既に持っているコマンド/語彙
理由: 陳腐化するものをスキルに焼き込むとメンテ負債になり、汎用スキルと重複させると二重管理になる。スキルは「調べれば分かること」ではなく「毎回ハマる固有の罠と戦略」に絞ると寿命が延びる。
(初版スキル提案に前提・バージョン・具体セレクタまで盛り込んだところ、ユーザーが「できるだけ汎用めが良い」「前提はほぼ削れる。バージョンや一覧はすぐ陳腐化し、コマンドや語彙は汎用スキルが持っている。個別セレクタも現物に残っているので、スキルには戦略レベルだけ載せる」と訂正し、範囲を絞らせた実例から。)