Rules 是写入 Harness、在每次 Run 中稳定注入的行为约束与项目约定。它们不依赖模型「记住」,而是通过 IDE/Agent 配置强制进入上下文。
典型形态:.cursor/rules/*.mdc、AGENTS.md、用户级 Personal Rules。
Rules ──► System / 前置上下文 ──► Model
(高优先级、低 token 变动)
| 对比 | Rules | Skills |
|---|---|---|
| 触发 | 几乎始终生效 | 任务相关时由 Agent 读取 |
| 粒度 | 短约束、风格、安全 | 长流程、领域 SOP |
| 变更频率 | 低,需 review | 按任务类型扩展 |
- 可执行:写「必须跑测试」而非「请考虑质量」。
- 可分层:全局规则 vs 目录级
globs规则。 - 避免冲突:多条规则矛盾时 Model 会随机折中。
- 版本化:与代码同库,PR 可审查行为变更。
- 把整本架构文档塞进 rules(应放 RAG 或 Skills)。
- 重复 system prompt 已有内容(浪费上下文)。
- 隐式「团队默契」不写下来。
- rules-patterns.md — 规则分层与编写模式