SuperAPI AI 工具集

code-style

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:把最近编写或修改的代码对齐到项目自身既有约定,使新代码看起来像长期维护者所写。核心原则是匹配项目代码与配置中体现的真实习惯,而非个人偏好或通用最佳实践。

主要能力:自动识别改动范围(未提交改动,或当前分支与默认分支的差异)及现有格式化/检查工具配置与风格文档;先让项目已有的格式化器和 linter 处理机械性规则(缩进、引号、分号、行宽、尾逗号),工具不覆盖的命名、结构、惯用写法与注释则从同类邻近文件学习;对改动行做去“AI 味”处理,如删除冗余注释、不符合该区域的防御性检查、类型逃逸、无用兜底和多余嵌套。

使用方式:运行脚本 bash <skill-dir>/scripts/style-scope.sh 查看范围与工具,再阅读其指向的实际改动。JS/TS 可运行 npx prettier --write、npx eslint --fix、npx biome check --write 或项目脚本;Python 用 ruff format、ruff check --fix、black、isort;其他语言用 gofmt -w、cargo fmt、rubocop -a、mix format 等。对全新文件可放心运行工具;对已有文件仅在其余部分已整洁时运行,否则手动套用规则到改动行,或运行后回滚改动范围之外的编辑。

限制:只改风格,绝不改变行为;只动改动过的代码,不重排、重命名或“修复”diff 之外的既有代码。公共或导出符号只有在全新且未被引用时才可重命名,且需说明。生成文件、第三方代码、压缩包、锁文件和子模块应跳过。无既有代码库可参照时,退回语言标准工具默认值;用户要改行为、重构、修 bug 或配置 lint/CI 时,本技能不适用。