背景:用户确认仓库只保留 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)。
原 GIT-05 要求 subject 用英文祈使句,与团队实际书写习惯不符(已有提交均为 中文),且缺少中英混排与术语约定,容易写出 Chinglish、自造术语或中英标点混乱。 本次改动: - GIT-05 改为「提交信息一律使用中文」,type / scope 保留英文小写,规定祈使句、 字数(≤50 汉字 / 整行 ≤72 字符)与不加句末标点; - 新增 GIT-21~GIT-23:中英文间加空格、使用全角标点与反引号、术语沿用 PRD 术语表、 禁止 Chinglish 与无信息缩写; - 新增 §2.2 commitlint 配置要点:中文必须关闭 subject-case、拦截中文句号, 否则钩子校验实际无效; - 同步 03(commit-msg 钩子说明)、07(PR-01 标题用中文)与 AGENTS §7 / §9 / 附录。 影响面:仅文档,无代码影响。新规则对后续提交生效,已推送的历史提交不改写 (GIT-15 禁止改写 main 历史)。 回滚方式:git revert 本提交。
项目尚无统一工程规范,AI 助手与研发各自发挥导致返工风险。建立 总纲 + 细则两层结构:AGENTS.md 只写硬约束与索引(14 条红线、技术栈 基线、仓库结构、命令契约),细则拆为 10 份文档覆盖 Git、代码风格、 格式化、API 与路由、数据库、测试与 CI、Review、日志、密钥、资产命名。 影响面:仅文档。约束力从本轮起对新建代码生效;与现状冲突处以文档为准。 回滚方式:git revert 本提交。