SuperAPI AI 工具集

code-quality

编程与开发

查看项目

更新于 11-01 17:44

技能介绍

用途

code-quality 用于在明确范围内实现、修复、简化、重构或审查代码,目标是构建能完整满足既定行为的最小清晰方案。它要求先理解系统,仓库约定与用户明确决定优先于通用风格偏好。

主要能力

  • 确定范围与模式:使用用户指定的范围,否则使用当前任务的变更文件或分支差异;无法确定时先询问范围,而不是审计整个仓库。区分实现、缺陷修复、简化或审查模式;审查请求只授权给出发现,不授权直接修改。
  • 先找归属再写代码:按现有项目行为与模式、平台或标准库、已安装依赖、最后新增代码或依赖的顺序查找;追踪调用方与消费者,识别重复校验、默认值、契约、状态、缓存、转换、权限和错误处理,在合适的归属点修复根因,并复用等价行为。
  • 多维审视:同一范围下结合行为、归属、复杂度、类型、效率、测试六个视角,检查输出、错误、副作用、顺序与恢复是否正确,规则是否只在具备所需上下文的边界归属一次,嵌套、标志、间接层、包装、重复与死代码能否消除,契约是否保留精确的领域信息而不依赖类型转换或宽泛逃逸类型,是否存在已证实的不必要工作、I/O、分配、渲染或竞争,测试是否保护有意义的行为与失败模式而非镜像实现。
  • 实现一致的最终状态:偏好清晰命名、直接控制流与内聚职责;仅在确有概念、边界或真实复用时提取抽象;不添加推测性配置、无意义边界的接口、冗余状态同步、转发包装或未测量的缓存与记忆化。在不可信边界使用 unknown 并在该处收窄或解析,不拓宽领域契约再用断言恢复。
  • 处理契约变更与删除:对已批准的契约变更,同步更新生产者、消费者、测试夹具、测试与直接受影响的文档,并移除范围内被取代的路径;删除兼容性路径前确认真实部署、持久化、公开、外部或依赖分支义务,检查动态引用、配置、生成的消费者、迁移和相关发布边界;若义务在批准范围之外,保留边界并报告限制,不静默扩大任务。
  • 按比例验证:选择能暴露实际回归风险的最小检查并遵守仓库要求的门禁;对未变更代码复用已有通过证据;在共享边界、失败、重大风险或未解决问题时扩大检查。把测试当作维护代码:保留有用覆盖、合并重叠、移除过时或与实现耦合的用例;当回归测试能保护合理失败、边界或能力时再添加。
  • 收尾消融检查:审查最终差异中的缺陷、遗漏复用、重复归属、类型弱化、过时代码与测试以及不必要变动;对每个新增或保留的辅助函数、分支、测试、配置、兼容路径和层级,识别其提供的必要行为、清晰度、安全性或覆盖,移除仪式性复杂度但不移除其承载的职责。
  • 审查输出:先给出结论,按优先级报告可操作发现,包含位置、证据、后果与最小合理修复;没有有意义发现时明确说明。实现类任务列出变更内容与原因、验证结果和重大未解决限制;区分已确认缺陷与未验证疑虑,不在没有可比基线时声称速度、成本或令牌节省。

使用方式

该页面未提供安装命令或具体调用示例,使用方式暂未提供。从介绍看,它以技能说明形式约束代码工作的流程与审查输出格式,需在具备相应技能运行环境的场景中使用。

适用场景

适用于实现功能、修复缺陷、简化代码、重构、代码审查,以及在保持既有行为的前提下清理重复逻辑、类型弱化和过时测试。

限制

不强制固定审查者数量、模型、全量测试循环、函数大小限制、行数阈值或独立 PR 规则;未获授权时在本地内联审查。不要求每次编辑都配测试,不为迁就坏测试而弱化生产行为。未提供收费、价格、平台支持或效果数据。