Archery SQL 上线检查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4c1bfe98/archery-sql-check。
技能介绍
要解决什么问题
很多团队里,SQL 在开发库能跑通,并不等于能通过 Archery 生产工单门禁。把这两种结论混在一个「检查过了」里,是最容易在提测、合 master 前埋雷的:本地规则漏了、线上策略又多了一层,最后卡在工单里反复改。
这个技能把 开发库可执行 和 生产门禁通过 拆成两条硬要求,并规定你只能汇报三种固定结果:ARCHERY_PASS、ARCHERY_FAIL、STATIC_PASS_LIVE_NOT_RUN。
技能如何工作
- 先对齐仓库约定:改 SQL 前阅读项目的数据库与 Git 规范,避免和迁移、命名习惯打架。
- 本地确定性检查:运行
scripts/archery_sql_check.py,修掉全部报错,直到得到 STATIC_PASS。 - 权威 live 校验(有实例、库名、可用登录态时):优先用已登录的 Archery UI;否则用带
--live的 helper,变量与响应语义见references/archery-api.md。 - 汇报结论:live 无阻断 →
ARCHERY_PASS;有阻断 →ARCHERY_FAIL并修复重跑;仅静态通过但无法 live →STATIC_PASS_LIVE_NOT_RUN,不得称为可上生产。
捆绑检查器编码了已确认的公司规则(如不支持的 session/事务控制、存储引擎/排序子句、大 nullable 列、保留状态列、唯一索引命名等);live Archery 输出在策略冲突时以线为准。修复后需同步代码生成、ORM、迁移与文档中的列名与约束。
适用边界与注意点
- SQL 相关变更在未取得
ARCHERY_PASS前,不要标为可发布或推进到 test/pre/master;仅在交接中明确记录STATIC_PASS_LIVE_NOT_RUN及无法 live 的原因时,才可做dev-*草稿提交。 - 检查是校验,不是授权:不要在未另行要求时点击工单提交或执行 SQL;只向用户选定的 Archery 主机与库实例发送用户选定的 SQL 文件。
- 严禁存储、提交或回显 cookie、会话 ID、CSRF、JWT、库密码等;认证只在运行时通过已有登录 UI 或环境变量接受。
使用场景
- DDL/DML 改完要先跑 `archery_sql_check.py`,再决定是否具备提 Archery 工单的资格
- 合入 test 或 master 前,需要 live Archery 无阻断并得到 `ARCHERY_PASS` 才能标为可发布
- 本地已 STATIC_PASS,但 VPN/实例不可用,要按规范汇报 `STATIC_PASS_LIVE_NOT_RUN` 并写清原因
- Archery live 报额外策略,需按阻断项改 SQL 并同步 ORM、迁移与文档中的约束
适合人员
- 负责 Archery 工单提交流程的后端,需要区分静态通过与生产门禁通过
- 写迁移/手工 SQL 的 DBA 或平台工程师,要在合分支前把公司 SQL 规则跑齐
- 在 CI 外仍需人工 `--live` 校验的发布值班,要把三种结果用语写进交接
- 维护 `archery_sql_check.py` 与 references 的同学,要把 live 新规则沉淀进本地检查器