ソフトウェアエンジニアリングで利用するAIエージェント向けのスキル。
Agent Skills オープン標準に準拠する。1 skill = 1 ディレクトリ + SKILL.md。
実務で得た知見を skill として言語化し、判断を効率化する。調べれば分かる知識を溜める場所ではなく、「どう判断するか」の観点・勘所・型を再利用可能な形にして、評価・改善のサイクルを回す。標準ツールでそのまま使える状態を保つ。
「調べれば分かる知識」ではなく「実務による判断の知見」を skill にする。
skill にする
- 判断・意思決定の型（トレードオフの検討、観点の抜け防止、勘所）
- 実務・経験から得た暗黙知で、検索や公式ドキュメントでは一次的に得られないもの
- 繰り返し使うワークフロー・レビュー観点・チェックリスト（属人化を解きたいもの）
skill にしない
- 調べれば分かる事実・リファレンス（API 仕様、言語構文、公式ドキュメントの写し）→ 一次ソースへのリンクで足りる
- 判断を伴わない単なる情報の羅列
- 一度きり・使い捨ての手順
迷ったら: 「検索や公式ドキュメントで代替できるか？」を問う。代替できるならリンクで足り、skill にしない。代替できない「判断の型・観点・勘所」なら skill にする。
Agent Skills（Anthropic が策定したオープン標準）を唯一のスキーマとして採用している。
- 1 skill = 1 ディレクトリ +
SKILL.mdの単純な単位で、知識・チェックリスト・テンプレートをすべて表現できる。 - プログレッシブ・ディスクロージャにより、メタ情報 → 本体 → 詳細の3段で必要な分だけ読み込め、コンテキスト消費を抑えられる。
- ポータビリティ。Claude Code / claude.ai / Agent SDK など標準対応ツールでそのまま読み込める。
engineering-prompts/
├── skills/ # 各 skill を格納
│ └── <name>/
│ ├── SKILL.md # 必須。概要・いつ使うか・判断基準・手順
│ └── reference/ # 任意。詳細・具体値・テンプレート・チェックリスト
├── AGENTS.md # エージェント向けの作業ガイド
└── README.md
| skill | 概要 |
|---|---|
| technical-review | コード・設計文書の技術判断をレビューする観点と進め方 |
| adr | アーキテクチャ決定記録の原則とテンプレート |
| guideline-authoring | ガイドライン（活動の進め方）の策定プロセス |
| design-principles | 設計原則（評価の基準）の策定プロセス |
| requirements-engineering | 要件と制約の区別・要件レビュー・仕様テンプレート |
| architecture-strategy | アーキテクチャ戦略・戦略レビュー |
| organization-design | チームの価値観（MVV）設計 |
| technical-writing | 文章・ドキュメントの執筆とレビュー |
skill を追加・編集するときの規約。
分類軸は「AI のモード」ではなく「能力・トピック」。役割・チェックリスト・成果物テンプレートも skill として表現する。
- 役割 → その役割が行うワークフローを skill にする
- チェックリスト → 該当トピック skill の
reference/*.md - 成果物テンプレート → 該当トピック skill の
reference/template.md
密接に関連する概念は 1 skill に統合し、reference/ で分割する。細かく割りすぎると、常時コンテキストに載るメタ情報が肥大化する。統合しても description に内包トピックをキーワードとして列挙し、自動発火の精度を保つ。
単一の凝集した概念にする。A-and-B のように 2 概念を連結した名前は避ける。連結したくなったら、統合しすぎかトピックの切り出しを誤っているサインとして見直す。
---
name: <ディレクトリ名と一致>
description: <何をする skill か＋いつ使うか。冒頭に主用途、続けてトリガーとなる語>
---- フロントマターは
nameとdescriptionの 2 つだけ。 - 出典があるときは本文末尾の「一次ソース」節に置く。
- 冒頭に概要と「いつ使うか」。続けて判断基準・手順。
- 500 行以内を目安とし、詳細・具体値・テンプレート・チェックリストは
reference/*.mdへ逃がす。 - 手順は「やること」を番号付き、「守ること」を箇条書きで書く。
- 日本語は直書きする（ユニコードエスケープを使わない）。
- 特定の出典から導いた skill は、末尾に「一次ソース」節を置く。実務から抽象化した skill には置かない（後付けで並べると出典を偽ることになる）。
標準書式（name + description）の検証ゲートは持たず、人手・エージェントで守る。エージェント向けの作業手順は AGENTS.md を参照。