SuperAPI AI 工具集

ai-full-code-review

测试与质量

查看项目

更新于 10-15 20:29

技能介绍

用途:审查分支差异,识别可能导致生产事故的真实风险,忽略外观、风格或低影响评论。

主要能力:对照 main 检查当前分支,使用 git rev-parse --abbrev-ref HEAD、git diff main...HEAD --stat、git diff main...HEAD;若在 main 上则停止并报告。每个发现需给出问题、为何重要(生产影响)、失败场景与修复建议,优先采用幂等、退避重试、saga、发件箱/收件箱、乐观锁、去重、限流等成熟模式;无相关风险时明确说明。输出格式参照 references/code-review-template.md。

使用方式:输出写入用户本地 Obsidian vault,按项目分组。Vault 根为 $OBSIDIAN_AI_VAULT,未设置时默认 $HOME/Documents/obsidian/obsidian。内容位于 <vault>/engineering/...,用 Read/Write/Edit 工具与绝对路径操作,ls 可用 Bash。笔记内 wikilink 保持 vault 根相对且不变。写入后用 ai-commit 技能提交,消息为 ai-code-review: <branch>,不直接运行 git add/commit/push。项目基础路径通过 git rev-parse --show-toplevel 的 basename 得到,非 git 仓库则提议 kebab-case 名称并与用户确认。每次审查在 engineering/<project>/code-reviews/ 下新建文件,文件名为 <timestamp>-<branch>.md,timestamp 来自 date +%Y-%m-%d-%H%M%S,branch 中非 [A-Za-z0-9._-] 字符替换为 -,不覆盖旧文件。H1 下添加项目链接,并维护项目 index.md 与 engineering/index.md 的链接。完成后报告最终 vault 路径。

限制:依赖本地文件系统与 git 仓库;若 ai-commit 报告无暂存、无 origin 或推送失败,简要报告后结束,不中止技能。ai-setup 负责配置仓库与 origin。收费、价格、平台支持等信息暂未提供。