Agent skill

glossary-creation

プロジェクト用語集(docs/glossary.md)を作成・更新する。 「用語集を作って」「用語を整理して」「用語の定義を統一」「glossaryを更新」 「このプロジェクトの用語を定義」「専門用語をまとめて」などの依頼時に発火。 docs群から用語を抽出し、定義・関連用語・使用例・実装箇所を整理して出力。

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/glossary-creation

SKILL.md

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 スキル
  • 一般的な技術用語の説明(プロジェクト固有でないもの)→ 外部ドキュメント参照

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results