Mate Preflight

在 MateCloud 提交代码或开 PR 前使用。跑 harness 约束校验、修掉违规、按规范写提交信息。当用户说"提交前检查""preflight""要提交了""commit 之前自检"时触发。

mateaix ef45878 1.8 KB Updated

File contents

提交 / 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}): ...

mateaix/matecloud/tree/main/.claude/.harness/skills/mate-preflight commit ef458785b3

Frequently asked questions

npx skillmds@latest add mateaix/mate-preflight