SuperAPI AI 工具集

bugfix

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:在缺陷已经过 triage 后落地修复。前提是 triage 技能已产出当前分支上的失败测试、Linear 工单上的根因评论,以及依据 docs/bug-automation-allowlist.md 得出的“allow-list status: yes”判定;任一缺失都应中止并先运行 triage,不得在没有失败测试的情况下自行修复。

主要能力与约束:修复需满足源码改动不超过 100 LOC(测试不计)、替换优于删除(若删除超过 20 LOC 现有逻辑则视为重构而非修 bug)、只触及一个模块、不做 schema 迁移、不引入新依赖。超出限制时应停止,在 Linear 留言说明所需内容并交回人工。

使用方式:在当前 triage 分支上应用修复,使修复与测试一起落地;复用现有 helper 与工具,不为单个修复引入新抽象;编辑前阅读所在区域的 CLAUDE.md,必要时在 PR 正文引用所遵循的规则;除非原因会让未来读者意外,否则不加注释。随后运行 pnpm typecheck、pnpm lint、pnpm test:unit(若改动在 apps/studio 则从该目录运行)。若失败由修复引起,在 LOC 预算内迭代;若失败与修复无关且 main 上已存在,则停止并报告,不要推送。确认原先失败的测试通过后,用 gt create -m "fix(<area>): <one-line summary>" 与 gt submit --draft 提交并开 PR。PR 正文需包含根因、修复说明、允许清单类别、Closes 的 Linear 工单 ID 与验证信息,并打上 ai-authored、risk:<tier> 及来源 area:* 标签。最后在 Linear 更新工单,附 PR 链接与风险等级。

硬性规则:同一 PR 中必须有从失败转为通过的测试;绝不直接推送 main,始终通过 gt submit --draft;拒绝超过 100 LOC 源码改动,改为升级处理;绝不为让 CI 通过而删除现有测试;绝不编辑 prisma/、src/server/trpc.ts、src/server/modules/auth 或任何 risk:high 路径。

需拒绝的反模式:添加与失败测试无关的“防御性”检查;顺手重构文件;把两个 bug 合并进一个 PR;为让 CI 变绿而禁用不稳定测试;发明功能开关来门控修复。