提交 / PR 前自检
目标:让每次提交都过得了 harness,并符合提交规范。
第一步:跑约束校验
bash .claude/.harness/checks/run-all.sh
- 阻断级(竞品名 / 硬编码密钥 / OSS 边界 / 领域纯净)任一红 → 必须修到绿才提交。
- 告警级(MapStruct / AutoConfig / Flyway)→ 看是不是你这次引入的;是就一并修, 历史存量可暂留但别新增。
修法对照 .claude/.harness/rules/:每个 check 的 rule: 字段(见 manifest.yml)指向对应规则文件。
第二步:范围自查(别捎带无关改动)
git status --short
git diff --cached --stat
只暂存本次任务相关文件。不要顺手提交他人工作区改动、docs/tasks/(含内部路径)、
或 .claude/ 下除 .harness 外的本地配置。
第三步:提交信息规范
格式 {type}({scope}): {description},中文描述 OK:
- type:
feat/fix/refactor/docs/chore/test/style/perf - scope:模块名(
system/auth/gateway/harness…) - 示例:
fix(system): 用户查询分页参数校验缺失
提交信息末尾按本仓约定加 Co-Authored-By 行(若由 AI 协作)。
第四步:分支
当前在默认分支(main)就先开 feature/{name} 或 fix/{issue};
本项目日常工作流是提交并推送到 dev(除非另有要求)。
一键清单
-
run-all.sh阻断级全绿 - 未新增告警级违规
- 暂存范围干净,无无关文件 / 内部路径
- 提交信息
{type}({scope}): ...