用途 该技能用于评审或分诊 laravel/ai 的变更。它既可审查 PR 或分支差异,也可在尚无代码时,基于 bug 报告或功能请求的文本进行评估。
主要能力 使用前先确定输入:对代码,查看当前分支的 PR(gh pr view);若无 PR,则将分支与 0.x 做 diff,并把该 diff 视为 PR。对尚无代码的 bug 报告或功能请求,则直接从报告文本入手。
审查按四个要点依次进行:
- 提供商准确性:对照各提供商官方文档(AGENTS.md 中按提供商给出链接),确认关于其 API 的每一项断言,包括字段、端点、参数和行为。AGENTS.md 是各提供商能力的权威来源;与文档矛盾的断言应视为发现的问题,而非前提,这一要求同样适用于报告中的断言。
- 真实问题:判断广泛的 Laravel 开发者是否会遇到该问题,还是属于小众或人为构造;若解决的是无人遇到的问题,应明确指出。
- 方案合理性:评估方法是否正确、是否过度或不足设计、是否遗漏边界情况;若有根本不同的更优方案,应指出。
- 项目风格:变更须与代码库其余部分一致,包括 AGENTS.md 中的注释规则与架构、周边 gateway、provider 与 trait 的命名和结构,以及相邻测试的惯例;所有不一致之处都应标出。
对代码,还需逐项核对发布检查清单,每项未满足即为一项发现:
- 一项用户可见变更;无无关改动;超过约 10 个文件应拆分。
- Pint(仓库配置)通过;无手工格式化。
- 每个新公开名称按包内既有约定 grep 检查干净。
- 说明 BC 影响;按正确版本写入 UPGRADE.md 条目;更新约束版本。
- 测试畸形与失败路径输入;按规范校验外部载荷。
- Octane/队列安全:共享服务上无请求作用域状态。
- 每个查询与载荷均有界。
- Docblock 符合项目口吻;文字精炼;断言已对照代码核实。
- 删除死代码、别名与推测性钩子;每个测试断言都能失败。
- PR 标题描述变更本身,而非文件操作。
最后产出工作计划:逐条明确改进点、指出要修改的每个文件,并为每项变更指定测试文件;在 API 面允许时,给出变更使用的真实代码示例。
使用方式 按上述流程确定输入、依次评估四个要点、对代码核对检查清单,并输出工作计划。
适用场景 适用于 laravel/ai 的 PR 或分支差异评审,以及 bug 报告或功能请求的分诊。
限制 该技能面向 laravel/ai 项目;审查须以 AGENTS.md 与各提供商官方文档为准。资料未提供安装命令、收费或价格、平台等信息,暂未提供。