AgentSkillsCN

workspace-domain-glossary

为项目建立并强化共享领域词汇表，避免术语混淆与概念漂移。适用于需求规格或代码中涉及领域术语的场景。

SKILL.md
--- frontmatter
name: workspace-domain-glossary
description: Builds and enforces a shared domain vocabulary for the project to prevent terminology drift and confusion. Use when specs or code involve domain terms.
triggers: [spec-writing, requirement-review, business-logic-migration]
outputs: [glossary-update, terminology-alignment-report]

Workspace Domain Glossary

Purpose

Maintains a single source of truth for business terminology. This ensures that designers, developers, and stakeholders mean the same thing when using specific terms.

When to use this skill

  • •When writing or reviewing specifications
  • •During migration of complex business logic
  • •When detecting conflicting terminology in code or docs

Glossary Steps

  1. •Extract Domain Terms: Identify nouns and concepts unique to this business domain.
  2. •Define Canonical Meanings: Create one-sentence definitions that are universally accepted.
  3. •Detect Conflicting Usage: Flag cases where different terms are used for the same concept (e.g., "Customer" vs "User" vs "Client").
  4. •Enforce Consistency: Update code, specs, and docs to use the canonical term.

Decision Tree

mermaid
flowchart TD
    A[New Term Detected] --> B{In Glossary?}
    B -->|Yes| C[Apply Definition]
    B -->|No| D{Synonym Exists?}
    D -->|Yes| E[Redirect to Canonical Term]
    D -->|No| F{Critical Term?}
    F -->|Yes| G[Propose New Glossary Entry]
    F -->|No| H[Use standard language]

Review Checklist

  1. •Precision: Is the definition narrow enough to avoid confusion?
  2. •Universality: Is this term used the same way across all components?
  3. •Justification: Is there a strong reason for this naming choice?
  4. •Simplicity: Avoid jargon where plain language works.

How to provide feedback

  • •Be specific: "Term 'AccountExpiry' is used here, but glossary defines 'SubscriptionEnd'."
  • •Explain why: "Using multiple terms for the same concept increases cognitive load for maintainers."
  • •Suggest alternatives: "Recommend replacing 'AccountExpiry' with 'SubscriptionEnd' to match the domain glossary."

Never invent new terms without justification.