SuperAPI AI 工具集

review

编程与开发

查看项目

更新于 10-15 19:52

技能介绍

这是 ahonn/dotfiles 中的代码评审技能,用于在推送或提交 PR 前对代码变更做结构化两遍自审(Fix-First 方式)。

用途:审查分支差异、已暂存或未提交的改动,先做关键问题检查,再做信息性质量检查。

主要参数:--base 覆盖基线分支(默认通过 gh 或 main/master 自动检测);--scope 控制范围,branch(当前分支与基线的已提交差异,需功能分支)、staged(仅 git diff --cached)、uncommitted(工作区全部改动);--fix 自动应用机械性修复;--report-only 只报告不修复;--peer 通过后台 Agent 并行启动 Codex CLI 同行评审(需安装 codex-plugin-cc)。无参数时为交互模式。用户要求创建/提交 PR 时可先运行 /review --peer。

流程:自动检测范围并取 diff;第二遍分关键项(数据安全、竞态、安全边界、错误处理、破坏性变更)与信息项(死代码、魔法值、测试缺口、复杂度、一致性、性能)。每个发现按 AUTO-FIX/ASK/NOTE 分类处理。若启用 --peer 会整合 Codex 结果,区分双方共同发现与单方发现。

限制:--scope branch 在基线分支或无领先提交时中止;staged 无暂存改动时中止;依赖 codex-plugin-cc 插件,不可用时仅记录警告并跳过。评审反馈需先验证技术正确性,不盲目采纳。具体安装与更多细节暂未提供。