用途:staging-fix 用于在 staging 环境出现故障时,在本地诊断并修复问题,再经由已确认的 staging CI 路径发布,而不是直接操作服务器。
主要能力与规则:生产环境绝不访问;staging 默认关闭,只有在本次会话中用户明确批准只读检查并提供 SSH 访问后才可读取(数据库 SELECT、日志、容器与环境状态)。禁止直接变更 staging:不改服务器代码、配置、.env,不重启或重建容器,不改数据。修复只能通过 CI 部署,即合并 PR 后由 GitHub Actions 部署。若合并后使 staging 更糟,需通过同一 CI 路径提交 revert PR,不得在服务器上热修。任何远程写入前需一次合并批准;引用证据需脱敏;提交与 PR 不得含 AI 或工具署名;需包含工作区要求的 issue 标识。
使用方式:先复现或收集证据,本地复现失败时对比环境变量、特性开关、迁移与数据形态,修复仓库中的漂移。然后在指定交付分支上缩小复现、写失败测试并使其通过,清理调试标记,运行检查套件。接着读取 staging 部署工作流确认分支触发与目标,起草提交与 PR,经批准后执行: git push -u origin <branch> gh pr create --base <staging-branch> --head <branch> --title "<subject>" --body-file <approved-body-file> gh pr merge <pr-num> --auto <repository-supported-merge-flag> --match-head-commit <pushed-sha> 最后报告 PR 状态与部署预期。
适用场景:staging 环境故障的本地修复与经 CI 发布。限制:无本次会话批准则不得访问 staging;CI 路由缺失或含糊时停止发布;无法本地复现时需说明替代验证;不承诺部署结果。