القائمة
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。
التثبيت باستخدام 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 を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
skill と agent の authoring 資産を出荷前に検証する。draft の骨格確認、改善後の回帰確認、共有前の最低品質確認をしたいとき。
| name | new-agent |
| description | 新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。 |
この sub-skill は、custom agent を「何を判断する存在か」という責務から設計するための入口です。skill よりも権限と境界の影響が大きいため、まず役割を 1 文で固定してから雛形へ落とし込みます。
plugins/happy-coding/agents/ に追加したいとき「何を判断し、何を返し、何をやらないか」を先に定義します。これを曖昧にすると、既存 agent や skill と責務が重なりやすくなります。
必要な推論量と権限に応じて model と tools を最小化します。理由は、過剰な権限や過大な model は便利でも、運用コストと誤用リスクを増やすからです。
既存雛形を基準に frontmatter と本文構成を埋めます。description の trigger phrase（『こんなときに使う』相当）、役割、非責務、<領域名>の原則、プロセス、出力の型、注意点、完了条件 は _agent の正本契約として最低限そろえます。
plugins/happy-coding/agents/ に近い agent がある場合は見比べ、責務境界、語彙、出力の型をそろえます。ここを比較する理由は、新規 agent 単体では気づきにくい overlap を早く見つけるためです。比較対象がない場合は、template と instructions との整合を優先します。
作成後は同梱の検証スクリプトで frontmatter と section 構造を確認します。## 1. 役割 のような番号付き H2 や ## 設計プロセス / ## レビュープロセス のような既存 corpus にある見出し、師範 agent の legacy mode 構成も受け入れつつ、雛形由来の agent では 原則 セクションを必須として _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
| 段階 | 決めること |
|---|---|
| 役割定義 | 1 文の責務、非責務、隣接 agent との境界 |
| 権限設計 | model、tools、read-only かどうか |
| 草案化 | template に沿った frontmatter、原則、本文構成 |
| 整合性確認 | 近接 agent との比較 |
| 初期検証 | agent validator で骨格確認 |
../../_agent/ — agent authoring の内部資産../../_agent/references/agent-template.md — agent.md の雛形../../_eval/scripts/validate_agent.py — agent validator../validate-authoring/ — 変更後の検証ルート原則 セクションを省略しない: docs/PHILOSOPHY.md を agent 固有の判断原則に落とし込む部分が、既存 agent 群との一貫性を支えます。