SuperAPI AI 工具集

ai-sdk-review

编程与开发

查看项目

更新于 11-13 21:22

技能介绍

用途 该技能用于评审或分诊 laravel/ai 的变更。它既可审查 PR 或分支差异,也可在尚无代码时,基于 bug 报告或功能请求的文本进行评估。

主要能力 使用前先确定输入:对代码,查看当前分支的 PR(gh pr view);若无 PR,则将分支与 0.x 做 diff,并把该 diff 视为 PR。对尚无代码的 bug 报告或功能请求,则直接从报告文本入手。

审查按四个要点依次进行:

  1. 提供商准确性:对照各提供商官方文档(AGENTS.md 中按提供商给出链接),确认关于其 API 的每一项断言,包括字段、端点、参数和行为。AGENTS.md 是各提供商能力的权威来源;与文档矛盾的断言应视为发现的问题,而非前提,这一要求同样适用于报告中的断言。
  2. 真实问题:判断广泛的 Laravel 开发者是否会遇到该问题,还是属于小众或人为构造;若解决的是无人遇到的问题,应明确指出。
  3. 方案合理性:评估方法是否正确、是否过度或不足设计、是否遗漏边界情况;若有根本不同的更优方案,应指出。
  4. 项目风格:变更须与代码库其余部分一致,包括 AGENTS.md 中的注释规则与架构、周边 gateway、provider 与 trait 的命名和结构,以及相邻测试的惯例;所有不一致之处都应标出。

对代码,还需逐项核对发布检查清单,每项未满足即为一项发现:

  • 一项用户可见变更;无无关改动;超过约 10 个文件应拆分。
  • Pint(仓库配置)通过;无手工格式化。
  • 每个新公开名称按包内既有约定 grep 检查干净。
  • 说明 BC 影响;按正确版本写入 UPGRADE.md 条目;更新约束版本。
  • 测试畸形与失败路径输入;按规范校验外部载荷。
  • Octane/队列安全:共享服务上无请求作用域状态。
  • 每个查询与载荷均有界。
  • Docblock 符合项目口吻;文字精炼;断言已对照代码核实。
  • 删除死代码、别名与推测性钩子;每个测试断言都能失败。
  • PR 标题描述变更本身,而非文件操作。

最后产出工作计划:逐条明确改进点、指出要修改的每个文件,并为每项变更指定测试文件;在 API 面允许时,给出变更使用的真实代码示例。

使用方式 按上述流程确定输入、依次评估四个要点、对代码核对检查清单,并输出工作计划。

适用场景 适用于 laravel/ai 的 PR 或分支差异评审,以及 bug 报告或功能请求的分诊。

限制 该技能面向 laravel/ai 项目;审查须以 AGENTS.md 与各提供商官方文档为准。资料未提供安装命令、收费或价格、平台等信息,暂未提供。