Agent Skills
返回列表
Archery SQL 上线检查

Archery SQL 上线检查

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4c1bfe98/archery-sql-check。

技能介绍

要解决什么问题

很多团队里,SQL 在开发库能跑通,并不等于能通过 Archery 生产工单门禁。把这两种结论混在一个「检查过了」里,是最容易在提测、合 master 前埋雷的:本地规则漏了、线上策略又多了一层,最后卡在工单里反复改。

这个技能把 开发库可执行 和 生产门禁通过 拆成两条硬要求,并规定你只能汇报三种固定结果:ARCHERY_PASS、ARCHERY_FAIL、STATIC_PASS_LIVE_NOT_RUN。

技能如何工作

  1. 先对齐仓库约定:改 SQL 前阅读项目的数据库与 Git 规范,避免和迁移、命名习惯打架。
  2. 本地确定性检查:运行 scripts/archery_sql_check.py,修掉全部报错,直到得到 STATIC_PASS。
  3. 权威 live 校验(有实例、库名、可用登录态时):优先用已登录的 Archery UI;否则用带 --live 的 helper,变量与响应语义见 references/archery-api.md。
  4. 汇报结论: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 新规则沉淀进本地检查器