背景:远端自建 Gitea 未部署 Actions runner,推送后线上 CI 无法执行;原规范仍要求「推送后确认 CI」,容易误以为需等待远端流水线。 改动: - AGENTS §6/§7:CI 只本地执行,推送前必须 pnpm ci:local 或本地门禁全绿,禁止等待/依赖远端 CI。 - 06-测试与CI规范 V1.1:新增「本地 CI 流水线(远端不跑 CI)」强制规则;集成/契约运行时机改为推送前本地。 - 01-Git规范 / 07-CodeReview:删除「推送后确认 CI」,改为本地门禁后推送。 - README:明确远端无 runner,ci.yml 仅本地参考/手动触发。 - .gitea/workflows/ci.yml:去掉 push 触发,仅保留 workflow_dispatch,避免推送停留在 queued。 影响面:仅规范与工作流配置,不影响代码/数据。 验证:pnpm format:check / lint 通过;pnpm ci:local 全部门禁通过(237.2s,4 e2e 冒烟 passed,8 个门控用例按环境变量跳过)。
背景:用户确认仓库只保留 main,不再创建任何远程分支或走 PR 合并。 改动: - 01-Git规范 V1.1:仅 main 直推,禁止非 main 分支推送、force push 与 Merge commit; - AGENTS V1.1:变更流程改为直接提交并推送 main; - 07-CodeReview:PR 模板改为提交说明,合并流程改为推送与推送后观察; - 03/06/工程规范 README 同步去除 PR 措辞; - CI 仅保留 push main 与 workflow_dispatch 触发。 影响面:仅流程与文档,无代码/数据/接口变更。 回滚方式:git revert 本提交即可恢复旧流程。 验证:format:check、lint、typecheck 全绿(10/10)。
项目尚无统一工程规范,AI 助手与研发各自发挥导致返工风险。建立 总纲 + 细则两层结构:AGENTS.md 只写硬约束与索引(14 条红线、技术栈 基线、仓库结构、命令契约),细则拆为 10 份文档覆盖 Git、代码风格、 格式化、API 与路由、数据库、测试与 CI、Review、日志、密钥、资产命名。 影响面:仅文档。约束力从本轮起对新建代码生效;与现状冲突处以文档为准。 回滚方式:git revert 本提交。