用途
Superior Code Review 用于审查一次代码变更,范围可以是工作区改动、暂存区 diff、提交范围、分支、拉取请求或指定文件。它定位为“审慎的维护者”:目标是保护现有行为,而不是制造反对意见,更看重少量证据扎实的发现,而非面面俱到的评论;若无问题,直接给出“无发现”的结论也是有效结果。
主要能力
技能先建立审查契约:确认确切的审查对象;从需求、issue、文档或测试中获取预期结果与验收标准;了解仓库指令、支持环境、兼容性承诺和相关架构;辨别生成文件、迁移、依赖、配置与测试是否属于本次变更;确认用户只要求发现还是也授权修复。当目标含糊且不同基线会实质改变结论时,不审查推断出的比较。默认使用只读检查,审查请求本身不授权编辑文件、发表评论、批准 PR 或改变外部状态。
随后在上下文中检查变更:从 diff 入手,再查看足够的周边与关联代码,理解被改变的契约,并对照真实调用点、schema、测试和配置验证假设。优先关注可能导致以下后果的风险:输出、状态转换或副作用错误;授权、校验、隐私或信任边界失效;数据丢失、损坏、重复、竞态或部分完成;崩溃、不可用路径、被吞掉的失败或不可恢复状态;API、schema、存储数据、客户端或环境之间的兼容性破坏;明显的性能或资源回归;测试通过但变更行为未被验证。格式化、命名、个人风格或推测性重构,除非造成具体的维护或正确性风险且工具未覆盖,否则不作为缺陷上报。
使用方式
每条候选发现需经过证明:定位变更行或最小相关范围;追踪到达该处的执行或数据路径;说明触发问题的输入、状态、环境或时序;确认对用户、系统、安全、数据或兼容性的实际影响;检查是否已有其他层预防或处理;给出最小可信的修正方向而不写完整补丁。若触发条件在维护契约下不可能、影响只是假设,或仓库已正确处理,则丢弃该候选;未解决的问题标为“问题”而非“发现”。
验证采取适度原则:使用仓库已支持的安全只读检查,如定向测试、类型检查、linter、构建、静态分析或复现命令;未经授权不改动共享系统、不重新生成大范围产物、不安装依赖、不运行破坏性集成流程。报告时先列发现,按严重性和真实影响可能性排序,每条包含严重性与简短标题、精确文件与行位置、触发场景、具体后果、修正方向,必要时附置信度或缺失证据;同一根因的重复发现应合并。之后给出简短审查总结与已执行的验证。若无剩余可操作发现,直接说明,并列出未验证的重要区域。
适用场景与限制
适合日常代码变更审查、PR 评审、兼容性与回归风险排查,以及在明确安全、数据库、性能、测试、UI 等专项时与对应技能配合使用:安全聚焦或需威胁驱动深度时用 superior-api-security;schema、查询、事务、迁移或数据生命周期为核心时用 superior-database;性能证据与剖析为主时用 superior-performance;测试架构、可靠性或覆盖率需专门判断时用 superior-testing;视觉产品面问题用 superior-ui-audit;无障碍或响应式为明确范围时用相应技能;需对具体已观察故障做因果诊断时用 superior-debugging;流水线、产物晋级、发布或回滚需专门评估时用 superior-delivery;可用性目标、故障隔离、降级或恢复为核心时用 superior-reliability;仅在用户同时要求实现已确认的行为修复时用 superior-logic。未经明确范围,不把一般审查扩展为完整安全审计、架构重构、依赖迁移或实现任务。该技能的收费、运行平台与具体安装方式暂未提供。