메뉴
新しい 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 群との一貫性を支えます。