Agent skill

glossary-updater

プロジェクト プロジェクトの glossary.md 用語集を更新するスキル。PRD/FRD 文書変更、新機能追加、コードベース変更後に用語集同期が必要なときにこのスキルを使用する。「用語集更新」、「glossary 同期」、「新用語追加」などの要求でトリガーされる。

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/other/glossary-updater

SKILL.md

Glossary Updater

Overview

プロジェクト プロジェクトのドメイン用語集(docs/glossary.md)を最新状態に保つスキル。PRD/FRD 文書、コードベース(enum、型定義)から新用語を発見して用語集に追加する。

トリガー条件

次の状況でこのスキル使用を提案する:

  1. PRD/FRD 文書変更後: docs/features/ フォルダの文書が修正されたとき
  2. 明示的要求: 「用語集更新」、「glossary 同期」、「新用語追加」
  3. 新機能実装完了後: 新 enum、モデル、サービスが追加されたとき

ワークフロー

1. 現在の用語集分析

Read docs/glossary.md

用語集の現在のセクション構造と既存用語リストを把握する。セクション構造は references/glossary-structure.md を参照。

2. ソース分析(変更タイプに応じて選択)

A. 文書ベース分析(PRD/FRD 変更時)

# 変更された PRD/FRD 文書を読む
Read docs/features/{feature-number}/PRD-*.md
Read docs/features/{feature-number}/FRD-*.md

# 新用語抽出: 太字(**term**)、テーブル定義、新概念

B. コードベース分析(コード変更時) - Feature-First 構造

# 新しく追加された enum/型定義確認(Feature-First)
Glob src/features/**/types/*.ts
Grep "enum " src/features/**/types/
Grep "interface " src/features/**/types/
Grep "type " src/features/**/types/

# 新 API / コンポーネント確認(Feature-First)
Glob src/features/**/api/*.ts
Glob src/features/**/components/*.tsx

3. 欠落用語識別

既存用語集とソースを比較して欠落した用語を識別する:

  • 新 enum 値(例: GamePhase, BattleMode
  • 新型定義(例: BattleResult, PlayerState
  • PRD/FRD で定義された新概念

4. 用語追加

用語追加形式

各セクションに適したテーブル形式で追加:

ビジネス/ゲームシステム用語:

markdown
| **Term** | 日本語 | 説明 | 実装例 |

技術用語:

markdown
| **Term** | 説明 | 実装 |

セクション選択基準

references/glossary-structure.md のセクション分類基準に従う。

5. 検証および完了

  1. 目次と本文のセクション番号一致確認
  2. マークダウンテーブル形式検証
  3. 改訂履歴更新(バージョン番号増加)

注意事項

  • 重複防止: 既に存在する用語は追加しない
  • 一貫した形式: 既存テーブル形式と同じように維持
  • 日本語説明: すべての説明は日本語で作成
  • 実装例: 可能であれば実際のファイル名/型名を明示

Resources

references/

  • glossary-structure.md: 用語集セクション構造および分類基準

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