| name | validate-authoring |
| description | skill と agent の authoring 資産を出荷前に検証する。draft の骨格確認、改善後の回帰確認、共有前の最低品質確認をしたいとき。
|
Authoring 資産を検証する
この sub-skill は、skill と agent を同じ入口から検証しつつ、実際の check は対象ごとに分けるためのルートです。入口をそろえる理由は、公開前に「どこまで確認したか」を 1 つの会話で揃えられるようにするためです。
ゴール駆動で使うため、最初に達成したいゴール、成功条件、確認手段を短く固定します。
こんなときに使う
- 新しい skill が最低限の構造を満たすか確認したいとき
- 新しい agent が frontmatter と section 構造を満たすか確認したいとき
- 改善後の asset に回帰がないか見直したいとき
- sync や共有の前に最低限の品質ラインを通したいとき
ワークフロー: authoring 資産を検証する
ステップ 1 — 対象を skill / agent に分ける
同じ authoring 資産でも、skill は workflow と route、agent は責務と権限を見るため、最初に対象を分けます。ここを混ぜると、check の意図がぶれます。
ステップ 2 — skill は既存 validator を通す
skill では既存の validate_skill.py を使い、まず L1、必要なら L2 まで進めます。最小構造が崩れている skill は、その先の review に進めません。
uv run python plugins\happy-core\skills\copilot-authoring\_skill\_eval\scripts\validate_skill.py plugins\happy-core\skills\<skill-name>\SKILL.md --level L1
uv run python plugins\happy-core\skills\copilot-authoring\_skill\_eval\scripts\validate_skill.py plugins\happy-core\skills\<skill-name>\SKILL.md --level L2
ステップ 3 — agent は同梱 validator を通す
agent では name / filename 一致、trigger phrase(『こんなときに使う』相当)、必須 section、構造の型を確認します。## 1. 役割 のような番号付き H2、## 設計プロセス / ## レビュープロセス、師範 agent の legacy mode 構成も許容し、既存 agent 群と同じ型を保ちます。template 系 agent では 原則 と step 構造を最低線とします。これは prose の良し悪しではなく、利用者が agent を見つけて安全に使えるかの最低線です。
uv run python plugins/happy-core/skills/copilot-authoring/_eval/scripts/validate_agent.py plugins/happy-coding/agents/<agent-name>.agent.md --level L1
uv run python plugins/happy-core/skills/copilot-authoring/_eval/scripts/validate_agent.py plugins/happy-coding/agents/<agent-name>.agent.md --level L2
ステップ 4 — 境界変更なら周辺も見る
責務や入口の変化がある場合は、README、dispatch 記述、関連 skill / agent との整合性も見ます。validator だけでは boundary drift は拾いきれないためです。
早見表
| 対象 | 最低限の check |
|---|
| Skill | frontmatter、trigger、workflow、関連導線 |
| Agent | frontmatter、原則を含む必須 section、step 構造、関連導線 |
| 境界変更あり | README、dispatch、近接定義との整合性 |
共通リソース
../../_skill/_eval/scripts/validate_skill.py — skill validator
../../_eval/scripts/validate_agent.py — agent validator
../improve-existing/ — 指摘を反映する改善ルート
注意点
- validator pass を完成と誤認しない: 自動 check は骨格確認であり、境界の妥当性までは自動で保証しません。
- L1 だけで満足しない: 公開前や共有前は、少なくとも L2 相当の読みやすさも見たほうが安全です。
- 境界変更を prose だけで閉じない: 周辺の導線が古いままだと、利用時の混乱が残ります。