name: glossary-creation description: > プロジェクト用語集(docs/glossary.md)を作成・更新する。 「用語集を作って」「用語を整理して」「用語の定義を統一」「glossaryを更新」 「このプロジェクトの用語を定義」「専門用語をまとめて」などの依頼時に発火。 docs群から用語を抽出し、定義・関連用語・使用例・実装箇所を整理して出力。
Glossary Creation Skill
プロジェクト内の用語を定義・統一し、認識の齟齬を防ぐ。
入出力
| 種別 | パス |
|---|---|
| 入力 | docs/product-requirements.md |
| 入力 | docs/functional-design.md |
| 入力 | docs/architecture.md |
| 入力 | docs/repository-structure.md |
| 入力 | docs/glossary.md(既存あれば優先) |
| 出力 | docs/glossary.md |
参照ファイル
| ファイル | 読むタイミング |
|---|---|
./template.md | 新規作成時のベース |
./reference.md | 用語抽出基準・レビュー観点 |
手順
1. 用語抽出
docs群を読み、以下の基準で用語を抽出:
- 繰り返し登場する専門用語
- 定義が曖昧になりがちな概念
- プロジェクト固有の造語・略語
- 一般用語だが本プロジェクトで特別な意味を持つもの
2. 既存用語集の確認
docs/glossary.mdが存在する?- Yes → 構造・既存定義を維持して追加・更新
- No →
./template.mdをコピーして新規作成
3. 用語の分類
./template.md のカテゴリに従って分類:
| カテゴリ | 内容 | 例 |
|---|---|---|
| ドメイン用語 | ビジネス・機能の概念 | 診断、稟議、推薦 |
| 技術用語 | 技術・FW・ツール | Supabase、RLS、RSC |
| アーキテクチャ用語 | システム設計の概念 | レイヤー、Repository |
| ステータス・状態 | システム内の状態値 | draft, active, archived |
| 略語・頭字語 | 略語とその展開 | PRD, KPI, DAU |
4. 各用語の定義
用語ごとに以下を埋める:
| 項目 | 内容 | 必須 |
|---|---|---|
| 定義 | 明確で一意な説明 | ✅ |
| 説明 | 補足・背景 | 任意 |
| 関連用語 | 他の用語へのリンク | ✅ |
| 使用例 | 「〇〇を△△する」形式 | ✅ |
| 実装箇所 | コード/テーブル名 | 技術用語時 |
5. レビュー
./reference.md のチェックリストで確認:
- 定義が曖昧でない(誰が読んでも同じ理解)
- 具体例がある
- 関連用語がリンクされている
- カテゴリ分けが適切
6. 出力
docs/glossary.md を作成/更新し、追加/変更した用語をサマリ提示
発火例
- 「用語集を作って」
- 「用語を整理して」
- 「このプロジェクトの専門用語をまとめて」
- 「PRDに出てくる用語を定義して」
- 「glossaryを更新して」
境界(やらないこと)
- 要件定義 →
prd-writingスキル - 機能設計 →
functional-designスキル - 一般的な技術用語の説明(プロジェクト固有でないもの)→ 外部ドキュメント参照