# 模块 1：规则体系的演进

<div class="mt-6 text-sm">

AI 编程工具正在把“项目规矩”从个人经验，推进到可读取、可分层、可复用的工程资产。

</div>

<div class="grid grid-cols-4 gap-4 mt-8 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-center">
<div class="font-bold">.vscode</div>
<div class="text-xs text-gray-400 mt-1">编辑器配置</div>
</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-center">
<div class="font-bold">.cursorrules / .mdc</div>
<div class="text-xs text-gray-400 mt-1">AI 私有规则</div>
</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30 text-center">
<div class="font-bold">.trae/rules</div>
<div class="text-xs text-gray-400 mt-1">分层规则目录</div>
</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30 text-center">
<div class="font-bold">AGENTS.md</div>
<div class="text-xs text-gray-400 mt-1">跨工具约定</div>
</div>
</div>

<!--
第三天从规则体系演进开始。
以前项目配置更多服务于编辑器和构建工具，现在规则开始服务于 AI 协作。
Trae、Cursor、Claude Code、Codex 都需要读取项目规则，规则文件正在从个人提示词变成团队工程资产。
-->

---

# 从散装规则到分层规则

<div class="mt-6 text-sm">

| 阶段 | 典型文件 | 核心价值 |
|---|---|---|
| 编辑器配置 | `.vscode/` | 统一格式化、插件、调试配置 |
| AI 私有规则 | `.cursorrules`、`.mdc` | 告诉 AI 项目偏好 |
| 工具规则目录 | `.trae/rules/` | 按场景拆分规则 |
| 跨工具规则 | `AGENTS.md`、`CLAUDE.md` | 让多种 Agent 读取同一套约定 |

</div>

<!--
这页讲清楚规则演进路径。
企业团队最关心的点是规则能否长期维护。
单文件规则容易越写越长，分目录规则可以按前端、后端、安全、测试、交付场景拆开。
AGENTS.md 的价值在于跨工具复用，同一个仓库可以被多个 Agent 正确理解。
-->

---

# Rules 的精细度升级

<div class="grid grid-cols-2 gap-4 mt-6 text-sm">
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">
<div class="font-bold mb-2">生效方式</div>

- 始终生效
- 指定文件生效
- 智能判断生效
- 手动触发
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
<div class="font-bold mb-2">适用场景</div>

- 前端组件规范
- 后端接口规范
- 安全检查规范
- 测试与交付规范
</div>
</div>

<!--
规则的价值来自精细度。
全局规则负责基础约束，文件规则负责模块约束，智能规则负责按描述匹配场景，手动触发规则负责课堂演示和专项任务。
这比一句“请用中文回答”更接近真实工程协作。
-->

---

# 规则分层示例

<div class="mt-5 text-sm">

```
.trae/
└── rules/
    ├── global.md
    ├── frontend.md
    ├── backend.md
    ├── security.md
    ├── testing.md
    └── delivery.md
```

</div>

<div class="mt-4 grid grid-cols-3 gap-3 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">全局：输出格式、语言、证据要求</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">模块：React、Java、API、数据库</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">流程：审查、测试、发布、回滚</div>
</div>

<!--
这页给一个可落地的目录示例。
讲师可以强调：规则文件的组织方式要贴合团队工作边界。
前端团队、后端团队、安全团队、测试团队都能维护自己负责的规则。
-->

---

# 规则迁移清单

<div class="mt-5 text-sm">

| 旧资产 | 迁移目标 | 检查点 |
|---|---|---|
| `.cursorrules` | `AGENTS.md` 或 `.trae/rules/global.md` | 是否仍适用于全项目 |
| `.mdc` | `.trae/rules/*.md` | 是否需要按文件范围拆分 |
| 口头规范 | `security.md`、`testing.md` | 是否能写成触发条件 |
| Review 经验 | `delivery.md` | 是否能形成验收标准 |

</div>

<!--
第一个练习让学员把现有团队规则做一次迁移。
目标是从散落在聊天记录、文档和个人经验里的规则，整理成 Agent 可读取的规则资产。
-->