SuperAPI AI 工具集

style-refresh

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

style-refresh 是 snowflake-labs/cocoplus 项目提供的一项技能,目标是根据项目证据刷新 CocoStyle 约定。

用途:实现 $style refresh [--source <path>] [--learning] 命令,用于维护项目内的风格与约定记录。

主要能力:读取已有约定,以及针对性的项目证据,例如文档、计划、变更日志条目和已接受的评审;仅将证据支持的规则更新到 .cocoplus/lifecycle/conventions.json 中。在学习模式下,新的建议会被标记为 proposed,直到被接受。

使用方式:通过 $style refresh 命令触发,可用 --source <path> 指定证据来源路径,用 --learning 启用学习模式。技能还要求命令行为与所属功能契约一致,明确所需的读取、写入和用户可见输出,并保留安全、治理和产物约束;缺少状态时应给出清晰且非破坏性的结果。

适用场景:需要基于项目实际证据维护或更新 CocoStyle 约定的开发工作流中。

限制:不得在缺乏证据或操作者明确确认的情况下,将一次性偏好转为全局约定;不能仅因文件存在就认为技能完成,也不能因为命令较小而跳过产物与安全检查。