Mate Preflight
Testing & Qualitymate-preflightMate Preflight is an Agent Skill for testing & quality published in the mateaix/matecloud repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
在 MateCloud 提交代码或开 PR 前使用。跑 harness 约束校验、修掉违规、按规范写提交信息。当用户说"提交前检查""preflight""要提交了""commit 之前自检"时触发。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/mateaix/matecloud/blob/HEAD/.claude/.harness/skills/mate-preflight/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/mate-preflight, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
提交 / 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}): ...