用途:在撰写或评审规格、需求、设计文档、ADR、任务、术语表条目及领域/技术术语时,保持全仓措辞一致,优先复用已有术语而非新造。
主要能力与用法:先确认正在撰写或评审的产物;若存在 glossary/business.md(领域、产品、工作流、业务术语)和/或 glossary/technical.md(架构、实现、平台、协议术语)则阅读;提取项目中专有、技术性、被重载、歧义或反复出现的概念;与现有术语比对。若现有术语接近,先向用户询问是否复用或新定义,用户未回答前不要新建术语,除非确实不存在可行候选。选定后在该产物中一致使用,并把新术语加入合适的术语表文件。若缺少所需术语表文件,用表头 | Term | Definition | Use When | Avoid | 创建,定义保持一句话。
标记与配套文件:在非术语表产物(提案、设计、规格、ADR、任务)中,仅对配套术语引用里出现的术语在正文加粗,代码块、frontmatter、链接等位置不加粗。每个撰写或编辑过的非术语表产物,在同目录生成配套文件,命名方式为去掉 .md 后加 -glossary-reference.md,如 proposal-glossary-reference.md、design-glossary-reference.md、spec-glossary-reference.md、adr-glossary-reference.md、tasks-glossary-reference.md。格式为 # Glossary Reference 加表格 | Term | Source Glossary | Context |,Source Glossary 写术语来源文件;若无术语被引用,写 # Glossary Reference 与 No glossary terms referenced.;不要把定义复制进配套文件。术语表源文件本身不生成配套文件。限制:不要添加通用词典词或一次性实现细节。