SuperAPI AI 工具集

setup-coding-standards

编程与开发

查看项目

更新于 10-16 02:29

技能介绍

用途:为仓库初始化编码标准文件。当仓库根目录没有 CODING_STANDARDS.md(及其大小写变体)时,生成该文件;已存在则停止并报告路径,不写入任何内容。

主要能力:先确定仓库根目录,运行 git rev-parse --show-toplevel,若无 git 根则使用当前工作目录。随后检查根目录是否存在 CODING_STANDARDS.md 及近似变体。生成时,读取本技能目录下的 references/baseline.md,原样复制作为文件开头,不重命名或调整其标题结构;基线以标记注释结尾,仓库约定只能写在标记之下。之后追加从当前代码中核实到的仓库约定,需有代码证据、不得编造、不得留空标题;注释不算证据,注释声称的约定必须对照其描述的代码核实,否则舍弃;仅重复格式化器、linter 或类型检查器已强制内容的约定应跳过。若没有可核实的约定,文件仅含基线。写入后读回确认内容一致。

使用方式:在目标仓库中调用该技能,按上述步骤执行;最终报告路径、写入内容(仅基线,或基线加哪些约定),并说明扩展该文件是单点编辑——新规则都加在此处,每条规则只有一个归属位置。

限制:不覆盖已有标准文件;不发明约定;不写入无证据内容;基线部分必须与 references/baseline.md 完全一致。其他细节暂未提供。