用途
grove-glossary-view 用于展示当前 CocoGrove 通用语言(ubiquitous language)术语表,帮助团队查看项目中已定义的领域术语及其相关信息。它以只读方式呈现术语表内容,便于统一团队对领域概念的理解。
主要能力
- 按字母顺序显示术语表中的所有条目。
- 每条术语展示:术语名称、定义(Definition)、别名(Aliases)、关联函数(Associated functions)、添加日期(Added)。
- 标题区显示术语总数([N] terms)以及术语表文件的最近更新时间(取自 glossary.md 最近一次 git 提交的日期)。
- 读取路径为 .cocoplus/grove/language/glossary.md。
使用方式
调用命令:$grove glossary view
执行流程:
- 验证初始化:检查 .cocoplus/ 是否存在。若不存在,输出 “CocoPlus not initialized. Run $pod init first.” 并退出。
- 检查术语表文件:读取 .cocoplus/grove/language/glossary.md。若文件不存在或为空,输出 “Glossary is empty. Run $grove glossary to propose and add domain terms from project artifacts.” 并退出。
- 解析条目并按术语名称字母顺序排序。
- 逐条展示,格式示例如下:
CocoGrove Ubiquitous Language Glossary [N] terms | Last updated: [date from most recent git commit on glossary.md] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
accuracy baseline Definition: The measured accuracy of a model version used as the reference point for evaluating whether a new version improves or regresses. Aliases: evaluation baseline, baseline score Associated functions: ai-classifier-v2, sentiment-scorer Added: 2026-05-01
churn propensity Definition: A numeric score (0-1) representing a customer's likelihood to cancel or disengage within the next 90-day period. Aliases: churn score, propensity score Associated functions: churn-predictor Added: 2026-04-28
gold standard dataset Definition: A manually labeled dataset used as the canonical evaluation set for all accuracy measurements on a Cortex AI function. Aliases: labeled test set, evaluation set Associated functions: sentiment-scorer, ai-classifier-v2 Added: 2026-04-20
[...continues alphabetically...] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Run $grove glossary to add new terms.
适用场景
- 需要快速查阅项目中已定义的领域术语及其别名、关联函数时。
- 团队协作中统一领域语言、核对术语定义时。
- 在添加新术语前,先查看现有术语表内容。
限制与约束
- 前置条件:.cocoplus/ 必须已初始化。
- 该技能为只读展示,不写入任何文件。
- 不得创建任何 git 提交。
- 不得修改术语表文件。
- 不得重排或重构术语表条目,必须按字母顺序原样展示。
错误情况
- 术语表文件缺失或为空:提示用户运行 $grove glossary。
- 无法读取术语表文件:输出文件系统错误。
完成标准
- 术语表条目已按字母顺序显示。
- 未写入任何文件(只读展示)。