SuperAPI AI 工具集

gf-review

办公与效率

查看项目

更新于 10-15 21:53

技能介绍

用途:GF Review 为 OpenSpec 开发流程提供结构化的代码与规范审查,以 CLAUDE.md 作为所有审查标准的唯一来源。

触发方式:自动触发包括 /opsx:apply 每个任务完成后、/gf-feedback 每个任务完成后、执行 /opsx:archive 之前;手动触发为用户明确要求“review this code”“check spec compliance”或 /gf-review。

审查流程:先确定范围,从仓库状态而非仅 git diff 入手,运行 git status --short 与 git ls-files --others --exclude-standard,把已暂存、未暂存、未跟踪文件及未跟踪目录(?? path/)都纳入候选,未跟踪目录需展开为具体文件(find <path> -type f 或 rg --files <path>);生成器产出的未跟踪文件也要纳入。git diff 仅作二次收窄。随后运行 openspec status --change "<name>" --json 了解变更状态,并读取 CLAUDE.md 加载规范。

审查类别:后端代码(apps/lina-core 下变更,调用 goframe-v2 技能);RESTful API(任何端点变更);项目规范(任何实现变更);SQL(manifest/sql 等路径下新增或修改文件,检查命名与版本、种子与 mock 数据分离、幂等执行安全、种子写入风格,禁止 INSERT ... ON DUPLICATE KEY UPDATE 及显式写 AUTO_INCREMENT id);单元测试(Go 实现或 *_test.go 变更,要求同包聚焦覆盖,开发时用 go test ./path/to/pkg -run TestName,回归用 go test ./path/to/pkg)。

报告与分级:输出 GF Review Report,含变更、范围、文件数、范围来源及各分类结论与摘要;Critical 阻止归档必须修复,Warning 提示但可继续。集成点:/opsx:apply 任务完成后审查并可提议修复;/gf-feedback 任务完成后修复再标记完成;/opsx:archive 审查全部变更并在 Critical 时阻止。

限制:仅检查与变更文件相关的类别;范围识别必须包含未跟踪文件,不能只依赖 git diff;行为变更的 Go 代码缺少聚焦单元测试即视为问题,除非作者说明不适用;问题报告需含文件路径与行号;简单问题可提议自动修复。其他细节暂未提供。