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/other/glossary-creation-yuch4-dx-selecta-2

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

参照ファイル

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

手順

1. 用語抽出

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

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

2. 既存用語集の確認

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

3. 用語の分類

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

4. 各用語の定義

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

5. レビュー

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

6. 出力

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

境界(やらないこと)

  • 要件定義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