role skill の発火条件を明確化

[version-1]

role skill の発火条件を明確化

Summary

role-* の入口 skill が、調査・計画・助言・実装・リファクタリング・レビュー・Git 操作・機械作業のどの場面で使われるかを metadata だけで判別できるようにしました。

主な変更点:

• 8 個の role-* skill の description に発火場面と対象外の場面を明記
• 各 role に positive 1 件、negative 2 件の発火 eval を追加
• role 三層構造における routing 条件の配置方針を設計文書へ追記

やったこと

• role-advisor、role-gardener、role-implementer、role-planner、role-refactor、role-reviewer、role-scouter、role-worker の description を更新
• 近接 role 間の境界を確認する evals/evals.json を各 skill に追加
• docs/design-skill.md に、routing 条件は入口 description、実行手順と判断基準は playbook に置く方針を明記
• PR 前レビューの Medium 指摘を反映し、曖昧だった期待 routing を一意化

動作確認

• skill-creator quick_validate.py: 8/8 成功
• eval JSON の構文検証: 8/8 成功
• Codex forward-test: positive 8/8、negative/routing 16/16 成功
• git diff --check: 成功
• make deploy-dry-run: 成功
• make deploy: 成功

レビュー & 動作確認 チェックリスト

• role 間の責務境界 - description の発火場面と対象外の場面が適切か
• eval の代表性 - positive / negative が主要な routing 境界をカバーしているか
• 三層構造との整合 - 入口、agent 定義、playbook の情報配置が重複していないか

推奨テスト計画:

1. 各 SKILL.md の description と対応する eval prompt を比較する
2. 近接 role の negative prompt が期待する別 role へ routing されることを確認する
3. make deploy-dry-run で配布対象を確認する

その他気になることや相談ごと

なし