SuperAPI AI 工具集

post-refactor

编程与开发

查看项目

更新于 10-25 17:17

技能介绍

用途

该技能用于重构完成、清理系列或少量相关 PR 合并后的清洁代码扫尾检查。它并非完整的 PR 审计,也不重新讨论已合并的工作,主要回答一个问题:被改动的代码是否变得更干净、更安全、覆盖更充分,还是留下了回归和清理债务。

范围确定

优先选取最窄且有用的范围:若用户指定范围则严格使用;若刚发布版本,则检查上一标签以来的变更(git describe --tags --abbrev=0 HEAD^ 得到 PREV_TAG..HEAD);否则检查最近 3-8 个相关提交或已合并 PR。若范围跨越不相关领域,按子系统分组分别审查。除非发现显示真实风险,否则不扩展为完整架构评审。

工作流程

  1. 建立变更面:收集提交范围与简日志、按子系统分组的变更文件、依赖/配置/schema 变更、新增或修改的测试、涉及的公开/用户界面。优先使用轻量 git 命令和针对性阅读,不读取整个仓库。

  2. 运行本地安全门禁:运行项目文档化的变更后检查;若未文档化,则根据技术栈推断常规格式化、lint/静态分析、测试和安全/依赖检查。Rust 仓库可优先使用:

cargo fmt --check
git diff --check
TAILWIND_SKIP=1 cargo test --workspace
TAILWIND_SKIP=1 cargo clippy --workspace --all-targets -- -D warnings

在可用时运行漏洞/依赖检查(cargo audit、cargo deny、npm audit、bundle audit 等)。工具不可用与发现问题是两回事:“工具未安装”是验证缺口,不是通过。

  1. 审查变更代码的重构残留:检查行为、默认值、序列化、迁移、认证、作用域解析、IO 边界或错误处理引起的回归;运行时路径中新出现的 unwrap、expect、panic、unreachable、宽泛捕获、忽略错误或有损回退;应合并的重复辅助函数或重复逻辑;仅有一个真实调用方且无具体需求的过度抽象(新 trait/泛型/公共 API);应改为命名常量、配置或注释的魔法值;与行为不符的过期注释/文档;重构引入的模块或 crate 间隐式耦合;数据丢失、破坏性操作、认证绕过、密钥泄露或不安全的路径/作用域处理。偏向实用的清洁代码修复,不要求为一次性逻辑做抽象,除非重复已导致漂移或风险。

  2. 审查测试质量与抖动风险:检查变更行为是否有聚焦测试,查找缺失的回归测试、断言实现细节而非行为的测试、隐藏有意义断言的过宽快照/黄金测试,以及依赖休眠/超时、挂钟时间、网络、共享全局状态、非临时文件系统写入、随机顺序、当前用户/主目录、跨测试污染的测试。若测试在会话中曾显得不稳定,重新运行该精确目标一次再分类;若重跑通过,报告为“观察到瞬时问题”并附证据,而非确定已修复。

  3. 分级发现:BLOCKING(可能回归、漏洞、数据丢失、认证/作用域绕过、门禁失败、可复现抖动或发布/部署阻塞);SHOULD-FIX(可能增长或困扰下次变更的可维护性/测试缺口、有漂移风险的重复逻辑、真实行为变更缺少聚焦测试);NIT(可安全延后的清理/文档/可读性问题);OBSERVATION(已验证健康区域或无需变更的观察项)。每条发现需包含文件/路径与行号(如可用)、为何重要、建议修复或下一步检查、是否经命令/测试/阅读验证。

  4. 修复策略:除非用户明确要求修复发现,否则不自动编辑代码。该技能主要是一次聚焦评审/检查。若请求修复,保持改动小,并在每批后运行相关聚焦门禁。

专项路由

范围涉及大量文件时使用 @explorer 做广泛变更面映射;使用 @oracle 对变更面做代码评审、可维护性、安全或抖动风险评审;仅在发现被接受且实现范围明确后使用 @fixer;仅对用户可见的 UI/UX 回归使用 @designer。

输出格式

最终报告保持紧凑:

## Post-refactor result

Range: <range>
Gate: <pass/fail/partial>

### Findings
- [SEVERITY] <file:line> — <issue>. <recommended action>

### Coverage / flake notes
- <summary>

### Clean-code notes
- <summary>

### Suggested next step
- <one concrete next action, or "none">

若无必需变更,直接说明并列出通过的检查。

适用场景与限制

适用于重构或合并少量 PR 后的快速质量检查,尤其关注最近变动代码。不适用于完整架构评审或重新审计已合并工作;不自动修改代码;具体收费、平台支持等信息暂未提供。