docs(ci): 同步远端 CI 已启用与推送前本地门禁要求
ci / 质量门禁 (push) Failing after 2m11s

背景:自建 Gitea 已部署 Actions runner(gitea-runner-01),旧文档
「远端无 runner、CI 只本地执行」已与事实不符。

改动:AGENTS.md、README、01/06/07 三份细则统一改为「推送前本地门禁强制 +
push main 自动远端 CI,失败即以新提交修复」,并注明 ci-smoke.yml 可手动冒烟;
AGENTS 版本升 V1.2,01/06/07 版本升 V1.2。

影响面:仅文档与索引版本号,不改代码与流水线行为。
回滚方式:revert 本提交。
验证证据:prettier 检查通过;文档相对链接未变。
This commit is contained in:
Stev_Wang committed 2026-11-04 17:52:24 +08:00
1 parent 88d9c77522
commit a06043ce92
5 files changed
+24 -23

No files matched your search

+4 -4
View File
@@ -7,7 +7,7 @@
| --- | --- |
| 适用对象 | 前端 / 后端 / 测试 / 运维 / AI 工程 / 产品(技术边界) |
| 适用产物 | 代码、配置、脚本、迁移、文档、Prompts |
| 文档版本 | V1.1(2026-11-02) |
| 文档版本 | V1.2(2026-11-04) |
| 事实基线 | PRD `V1.6`、技术架构 `V0.4` |
---
@@ -114,7 +114,7 @@ docs/ PRD / 技术架构 / 立项建议 / 工程规范
| 开发 | `pnpm dev` |
| 构建 | `pnpm build` |
| 质量 | `pnpm lint` · `pnpm lint:fix` · `pnpm format` · `pnpm format:check` · `pnpm typecheck` |
| 测试 | `pnpm test` · `pnpm test:int` · `pnpm test:e2e` · `pnpm ci:local`(CI 只本地执行,远端无 runner) |
| 测试 | `pnpm test` · `pnpm test:int` · `pnpm test:e2e` · `pnpm ci:local`(推送前本地强制;远端 Gitea runner 已就绪,push `main` 自动跑 `.gitea/workflows/ci.yml`) |
| 数据库 | `pnpm db:init`(迁移 + 幂等种子,不重置数据)· `pnpm db:migrate` · `pnpm db:reset`(清库重建;默认被拦截,必须 `ALLOW_DB_RESET=1` 显式确认;禁止手工删库 / 删数据卷) |
| 契约 | `pnpm openapi:diff` |
@@ -127,7 +127,7 @@ docs/ PRD / 技术架构 / 立项建议 / 工程规范
1. 基于最新 `main` 直接提交,小步 commit(**Conventional Commits,提交信息一律用中文**,`type` / `scope` 保留英文)。
2. 本地门禁:`pnpm format:check && pnpm lint && pnpm typecheck && pnpm test`。
3. 提交说明必含:**背景 / 改动 / 影响面 / 回滚方式 / 验证证据**;迁移、权限、AI、导出类变更须在推送前完成双人走查。
4. 直接 `git push origin main`;禁止 force push `main`,禁止 Merge commit。**远端 Gitea 未部署 Actions runner,线上 CI 不可用,禁止等待/依赖远端 CI**;CI 一律在推送前本地执行(`pnpm ci:local`),本地门禁全绿才能推送。
4. 直接 `git push origin main`;禁止 force push `main`,禁止 Merge commit。**本地门禁全绿才能推送**(`pnpm ci:local` 或至少 §7.2 四件套);远端自建 Gitea 已部署 Actions runner(`gitea-runner-01`),push `main` 自动执行 `.gitea/workflows/ci.yml`,推送后必须关注远端结果、失败立即修复,**不得以「远端 CI 会跑」替代本地门禁**。
5. 发布:staging 验证 → 生产灰度;**迁移先行、代码后行**。
细则:[Git 规范](docs/工程规范/01-Git规范.md) · [Code Review](docs/工程规范/07-CodeReview与PR规范.md) · [测试与 CI](docs/工程规范/06-测试与CI规范.md)
@@ -154,7 +154,7 @@ docs/ PRD / 技术架构 / 立项建议 / 工程规范
| API 与路由 | [04-API与路由规范](docs/工程规范/04-API与路由规范.md) | REST /api/v1、错误码、鉴权链、任务协议 |
| 数据库 | [05-数据库规范](docs/工程规范/05-数据库规范.md) | ULID、customer_id、游标分页、expand/contract |
| 测试与 CI | [06-测试与CI规范](docs/工程规范/06-测试与CI规范.md) | 分层测试、权限三态、覆盖率只升不降 |
| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | 提交说明、双人场景、DoD、本地 CI 后推送 |
| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | 提交说明、双人场景、DoD、本地门禁 + 远端 CI |
| 日志与可观测 | [08-日志与可观测性规范](docs/工程规范/08-日志与可观测性规范.md) | Pino 字段、trace_id、审计与日志分离、告警 |
| 环境变量与密钥 | [09-环境变量与密钥规范](docs/工程规范/09-环境变量与密钥规范.md) | `.env.example` 入库、启动校验、轮换与泄露处置 |
| 资产命名与图层 | [10-资产命名与PSD图层规范](docs/工程规范/10-资产命名与PSD图层规范.md) | 命名占位符、PSD 图层前缀、规格矩阵、低质量标记 |