style-show 是 snowflake-labs/cocoplus 项目中的一项技能,其目标功能为实现 $style show [--all] [--source] 命令,用于展示当前项目的 CocoStyle 约定。
用途:向用户呈现项目内已记录的 CocoStyle 风格约定,便于开发者了解并遵循当前项目的编码规范。
主要能力:按领域(area)分组显示约定;每条约定附带状态、置信度、来源证据和最后修改时间戳;默认隐藏已被取代(superseded)的约定,仅在使用 --all 时显示;支持 --source 参数。
使用方式:通过 $style show 调用,可选参数 --all 显示全部约定(含已取代项),--source 用于展示来源相关信息。资料未提供更多参数细节与具体输出格式。
适用场景:在开发过程中查询项目既有的风格约定,帮助保持代码一致性,或核查某条约定的来源与更新时间。
限制与要求:该技能强调技能契约需描述可观察的行为与验证方式,而非仅列出命令名称;即使是小型命令也需保留与大型操作相同的安全检查与产物约束;需说明必需的读取、写入及用户可见输出;当状态缺失时,应给出清晰且非破坏性的结果。资料未提供具体的实现代码、依赖项或安装步骤。