smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
135 lines
4.2 KiB
Markdown
135 lines
4.2 KiB
Markdown
# 模块 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 可读取的规则资产。
|
|
-->
|