SuperAPI AI 工具集

konsistent-fix-violations

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:运行 konsistent CLI,收集并修复代码库中的违规项。核心难点不是机械修改,而是当某条规则违规很多时,判断是规则错还是代码错,以及哪些非平凡违规值得处理。

主要能力与流程:按严格顺序执行——运行 CLI 并以 JSON 收集违规;按规则分组并识别高违规数规则;对高违规规则询问用户保留、修改还是删除;如需改规则,交由 konsistent-config 技能更新 konsistent.json;重跑 CLI 刷新列表,并在改代码前请求明确确认;将剩余违规分为平凡与非平凡;向用户展示非平凡违规并逐项决定;修复已批准项后重跑验证。步骤 3、5、7 的用户输入不可跳过。

用法:优先使用项目脚本(pnpm konsistent、npm run konsistent 或 yarn konsistent),否则用 pnpm exec konsistent、npx konsistent,最后回退 npx konsistent。检查命令为 <runner> konsistent check --format=json --max-diagnostics=1000。JSON 为 { severity, conventionName, filePath, predicateName, message } 数组,有错误时退出码非零属正常。改配置后运行 <runner> konsistent validate。修复后运行项目检查,如 pnpm typecheck、pnpm test、pnpm check。

适用场景:需要按 konsistent 约定批量整改代码、区分规则与代码问题、处理重命名与包边界兼容性时。

限制与注意:不得在步骤 4 后直接改 konsistent.json 来消音;不得跳过步骤 5 的确认;不得仅因消息短就判为平凡,需先读文件并搜索同名、大小写变体、前后缀、同位置等;重命名需更新所有引用;若零违规则报告并停止。详细规则见 node_modules/konsistent/docs/guides/fixing-violations.md 与 cli.md。