Claude-skill-registry glossary-creation

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/glossary-creation" ~/.claude/skills/majiayu000-claude-skill-registry-glossary-creation && rm -rf "$T"
manifest: skills/data/glossary-creation/SKILL.md
source content

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