style-mode 是 snowflake-labs/cocoplus 项目中的一项技能,主要用途是设置或显示 CocoStyle 的约定执行模式。其调用形式为 $style mode [observe|suggest|enforce]。\n\n主要能力:\n该技能会读取或写入 .cocoplus/modes/style.mode 文件,以此保存当前执行模式。三种模式的行为如下:observe 模式会记录偏离约定的情况,但不主动给出建议;suggest 模式会报告不符合约定的地方;enforce 模式在必须遵守的约定被违反时,阻止最终完成声明。执行后,技能会报告原模式、新模式和生效范围。\n\n使用方式:\n通过 $style mode [observe|suggest|enforce] 命令切换或查看模式,模式状态保存在 .cocoplus/modes/style.mode 文件中。\n\n约束与判定标准:\n技能合同需要描述可观察的行为和验证方式,不能只描述命令名称;即使命令规模很小,也不能跳过产物检查和安全检查,因为小命令同样会改变状态或引导执行。完成标准包括:命令行为与所属特性合同一致;所需的读取、写入和用户可见输出都已描述清楚;安全、治理和产物约束得到保留;缺少状态信息时给出清晰且非破坏性的结果。\n\n适用场景:\n适合在开发流程中按需调节代码风格约定的检查严格程度,从仅记录、到提示、再到强制拦截逐步收紧。
style-mode
编程与开发
更新于 10-23 23:08