SKILL.md

name: glossary-creation description: プロジェクト用語集（docs/glossary.md）を作成・更新する。「用語集を作って」「用語を整理して」「用語の定義を統一」「glossaryを更新」「このプロジェクトの用語を定義」「専門用語をまとめて」などの依頼時に使用。docs群から用語を抽出し、定義・関連用語・使用例・実装箇所を整理して出力。 allowed-tools: Read, Write, Edit, Glob, Grep

Glossary Creation Skill

プロジェクト内の用語を定義・統一し、認識の齟齬を防ぐ。

入出力

種別	パス
入力	`docs/product-requirements.md`
入力	`docs/functional-design.md`
入力	`docs/architecture.md`
入力	`docs/repository-structure.md`
入力	`docs/glossary.md`（既存あれば優先）
出力	`docs/glossary.md`

参照ファイル

ファイル	読むタイミング
`references/template.md`	新規作成時のベース
`references/guide.md`	用語抽出基準・レビュー観点

手順

1. 用語抽出

docs群を読み、以下の基準で用語を抽出：

繰り返し登場する専門用語
定義が曖昧になりがちな概念
プロジェクト固有の造語・略語
一般用語だが本プロジェクトで特別な意味を持つもの

2. 既存用語集の確認

docs/glossary.md が存在する？
- Yes → 構造・既存定義を維持して追加・更新
- No → references/template.md をコピーして新規作成

3. 用語の分類

カテゴリ	内容	例
ドメイン用語	ビジネス・機能の概念	診断、稟議、推薦
技術用語	技術・FW・ツール	Supabase、RLS、RSC
アーキテクチャ用語	システム設計の概念	レイヤー、Repository
ステータス・状態	システム内の状態値	draft, active, archived
略語・頭字語	略語とその展開	PRD, KPI, DAU

4. 各用語の定義

項目	内容	必須
定義	明確で一意な説明	✅
説明	補足・背景	任意
関連用語	他の用語へのリンク	✅
使用例	「〇〇を△△する」形式	✅
実装箇所	コード/テーブル名	技術用語時

5. レビュー

定義が曖昧でない（誰が読んでも同じ理解）
具体例がある
関連用語がリンクされている
カテゴリ分けが適切

6. 出力

docs/glossary.md を作成/更新し、追加/変更した用語をサマリ提示

境界（やらないこと）

要件定義 → prd-writing スキル
機能設計 → functional-design スキル
一般的な技術用語の説明（プロジェクト固有でないもの）→ 外部ドキュメント参照

スコア

総合スコア

50/100

リポジトリの品質指標に基づく評価

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です