메뉴
skill と agent の authoring 資産を出荷前に検証する。draft の骨格確認、改善後の回帰確認、共有前の最低品質確認をしたいとき。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
こんなときに使う: Ubuntu / Linux サーバーに SSH で接続し、sudo、systemd サービス、HTTP 監視を一連で安全に進めたいとき。 接続前に SSH_AUTH_SOCK を含む認証状態を固定し、認証で止まらずに サーバー接続・権限確認・サービス起動・停止・再起動・状態確認を一気に行いたいとき。
調査→修正→検証→ふりかえり/後続 Issue 化までを 1 つの改善ループで回したいときに使う。 実装前の再現確認や、review 指摘・検証結果をもとに次のアクションへつなぐ。
こんなときに使う: 現在の会話内容をもとに、実装・エージェント発注に直結する PRD を作りたいとき。 追加のインタビューはせず、すでに会話に出ている内容だけから構成する。 情報が不足している場合は捏造せず「未確定」として明示する。
こんなときに使う: ユーザーが「インタビューして」「質問して」「設計を詰めたい」などと言ったら使う。 計画や設計の重要な判断軸を洗い出し、具体例・反例・影響範囲まで深掘りして要件整理に落とす。
Copilot の custom skill / agent / repository instructions の作成・改善・構造確認を 1 つの入口にまとめる。複合スキルとして、対象に応じて適切な authoring ルートへ 分けつつ、実行時のモデル呼び出しを抑止してルーティングを優先する。試作から `plugins/*` 配布へ昇格するときの name / description 整備も扱う。skill / agent / repo-wide instructions / path-specific instructions を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。
| name | validate-authoring |
| description | skill と agent の authoring 資産を出荷前に検証する。draft の骨格確認、改善後の回帰確認、共有前の最低品質確認をしたいとき。 |
この sub-skill は、skill と agent を同じ入口から検証しつつ、実際の check は対象ごとに分けるためのルートです。入口をそろえる理由は、公開前に「どこまで確認したか」を 1 つの会話で揃えられるようにするためです。 ゴール駆動で使うため、最初に達成したいゴール、成功条件、確認手段を短く固定します。
同じ authoring 資産でも、skill は workflow と route、agent は責務と権限を見るため、最初に対象を分けます。ここを混ぜると、check の意図がぶれます。
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
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
責務や入口の変化がある場合は、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/ — 指摘を反映する改善ルート