1.5 KiB
1.5 KiB
项目开发约定
Git 提交规范
-
每个
TASK-*或后续工单都必须在独立 worktree 和分支中开发。 -
每个可验证的开发步骤完成后立即创建 Git 提交并推送到 Gitea
intelligrow组织下的对应远端分支，不得等第一版全部完成后再统一提交。 -
提交信息使用中文描述，采用 Conventional Commits 常见前缀，格式为：
<type>(<scope>): <中文描述> -
scope可选；描述应简短、明确，说明本次提交实际完成的内容，不写空泛描述。 -
常用前缀：
feat：新增功能fix：修复问题docs：文档修改refactor：重构，不改变外部行为test：新增或调整测试perf：性能优化build：构建或依赖调整ci：持续集成配置调整style：不影响逻辑的格式调整chore：其他维护工作revert：回滚提交
-
任务提交应包含任务号或范围信息，推荐格式：
feat(WP7-05): 增加候选环境覆盖证据门禁 fix(WP5-04): 修复资源访问安全边界 test(WP5-lineage): 增加连续提交链验证 -
提交完成后必须核对本地提交 SHA、远端分支和远端完整 SHA；本地未提交、推送失败或远端 SHA 不一致时，不得宣告任务完成，也不得开始依赖该任务的下一项任务。
-
不得在提交信息、日志、测试证据或代码中写入真实凭据、验证码、用户绝对路径或私有响应正文。