lex 是 CocoPlus 技能集中的一个项目词表(lexicon)状态查询技能,目标是通过实现 $lex 来展示当前 CocoLex 项目的词表状态。
用途:该技能面向使用 CocoPlus 进行项目管理的场景,帮助开发者快速了解项目术语定义的整体情况,便于维护一致的术语体系。
主要能力:执行时会先验证当前目录下是否存在 .cocoplus/ 目录。如果不存在,则输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。若已初始化,则读取 .cocoplus/lexicon.md 以及 .cocoplus/lexicon/ 目录下的所有 .md 文件,汇总已定义术语的数量、未定义的候选术语、术语之间的冲突,以及过时的提取术语。技能还提供以下子命令:$lex define、$lex list、$lex show、$lex extract、$lex validate。
使用方式:在已初始化的 CocoPlus 项目目录中运行该技能即可获得词表状态摘要;也可使用上述子命令进行定义、列出、查看、提取和校验等操作。技能说明中强调,命令行为需与所属功能契约一致,需描述必要的读取、写入和用户可见输出,并保留安全、治理与产物约束;缺少状态时应给出清晰且非破坏性的结果。同时提示不应仅因文件存在就认为技能已完成,也不应因命令较小而跳过产物与安全检查。
适用场景:适用于需要检查或维护项目术语表、确认术语定义完整性与一致性、发现未定义或冲突术语的开发与文档协作场景。
限制:必须先通过 $pod init 初始化 CocoPlus,否则技能不会执行;资料未提供更详细的参数说明、返回格式示例或与其他 CocoPlus 技能的集成方式,暂未提供。