SuperAPI AI 工具集

code-polish

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:code-polish 用于在实现完成后整理已改动的代码。它先一次性确定作用范围,只做高置信度的简化,再依据风险修复有证据支持的缺陷,并验证最终状态。仅在用户明确要求,或当前工作流请求实现后简化与按风险画像审查时使用。

主要能力: 简化(--simplify):保留公共契约、输入输出、副作用、错误行为、性能敏感特性、遥测与运维防护;只做有明确可读性或缺陷风险收益的改动,如压平可避免的控制流嵌套、澄清误导性命名或密集转换、在抽象能降低总复杂度时去除真实重复、收紧局部类型与契约、仅删除本次会话编辑造成的死代码。不做按行数拆分、架构清理、同步/异步 API 转换、投机性可配置化,也不把可读的重复替换为一次性抽象;无改动也是有效结果。 审查与修复(--review):对照用户请求判断 diff,按 CRITICAL → HIGH → MEDIUM → LOW 排序。每条发现须引用已验证位置、触发输入或状态、失败模式、影响范围与改动代码中的证据;合并重复项并采用最小可辩护修复。

使用方式:需在 Git 仓库中运行。作用范围可用显式路径、模式、范围、自然语言目标或已提供的 resolved-scope 块指定;否则只用本次会话修改的文件,会话历史不可用时用所有未提交的已跟踪与未跟踪文件。锁文件、生成产物、vendored 代码、压缩包和大数据快照默认排除在人工审查外,除非明确要求。范围解析后保持唯一权威集合,不再扩大或重算;为空则停止。模式开关:--simplify 仅简化;--review 仅审查修复;两者都不给或都给则先简化再审查简化结果。--with-profile <name> / --skip-profile <name> 添加或抑制审查画像,skip 优先。画像文件位于 references/profiles/<name>.md,缺失所选画像即停止。

适用场景:提交前的变更整理与风险审查,覆盖安全、配置、Go、Rust、TypeScript、Python、shell、数据格式与命名等画像。

限制:不改变公共契约,不做超出请求的重设计;行为一致性或高风险验证无法建立时停止。验证需运行最窄的格式化/检查、针对性测试、类型检查与不变量检查,并说明跳过的检查及原因。报告以 ### ✨ Code polish — ✅ complete 或 ⛔ blocked 开头,按 Resolved 与 Open 分组,每项只报告一次。具体收费、平台与安装方式资料暂未提供。