# 第 1 天到第 2 天

<div class="grid grid-cols-2 gap-8 mt-8">
<div class="p-4 rounded-xl bg-white/5 border border-white/10">

**第 1 天：** 让 TRAE 看懂若依代码
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">

**第 2 天：** 让 TRAE 按团队规则改若依代码

核心变化：从代码理解到研发治理
</div>
</div>

<!--
昨天我们使用若依作为真实开源项目，学习了如何让 TRAE 理解陌生代码库。
今天我们进入第二阶段：上下文工程与规则体系。
如果说第一天是“让 AI 看懂若依”，今天就是“让 AI 按团队规则分析、修改和检查若依”。
当团队多人都使用 AI 时，必须有统一上下文、统一 rules、统一验收标准，否则 AI 会带来不一致甚至风险。
-->

---

# 若依场景下的团队规则问题

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

**若依类后台项目常见风险：**
- 绕过权限，页面直接调接口
- 按钮权限当安全边界
- 接口缺少权限注解
- 操作日志缺失
- 代码生成后直接上线
- 敏感信息进入日志
</div>

<!--
若依这类后台系统，最容易出现的问题不是页面不好看，而是权限、日志、接口边界和生成代码质量。
AI 可能在页面里直接新增接口调用；只做前端按钮隐藏；没有检查后端权限注解；新增敏感操作但没有操作日志；用代码生成器生成 CRUD 后直接上线。
今天要把这些隐性开发要求写成中文规则，让 TRAE 在后续协作中长期遵守。
-->

---

# 今天三个关键词

<div class="grid grid-cols-3 gap-6 mt-10">
<div class="text-center p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">
<div class="text-2xl mb-2">🎯</div>
<div class="font-bold">上下文</div>
<div class="text-xs text-gray-400">决定 AI 看什么</div>
</div>
<div class="text-center p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
<div class="text-2xl mb-2">📏</div>
<div class="font-bold">规则</div>
<div class="text-xs text-gray-400">决定 AI 怎么做</div>
</div>
<div class="text-center p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">
<div class="text-2xl mb-2">📦</div>
<div class="font-bold">资产化</div>
<div class="text-xs text-gray-400">决定团队怎么复用</div>
</div>
</div>

<!--
今天仍然是三个关键词。
上下文决定 AI 看什么：看整个若依项目，还是只看用户管理模块，还是只看某个 Controller。
规则决定 AI 怎么做：不能绕过权限、不能遗漏操作日志、不能把前端权限当安全边界。
资产化决定团队怎么复用：好的 Prompt、rules、报告模板都应该进入团队资产库。
-->

---

# 模块 1：若依任务为什么要讲清楚？

<div class="mt-6 p-4 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">

**模糊任务：** 帮我优化用户管理模块

**问题：** 目标不清 · 范围不清 · 约束不清 · 输出不清 · 验收不清
</div>

<!--
在若依项目里，如果你直接问“帮我优化用户管理模块”，AI 很难给出可靠结果。
优化什么？权限？接口？页面？表单？数据权限？操作日志？代码结构？测试？
范围不清，AI 就会自由发挥。
所以若依这种后台系统，更需要上下文工程。
-->

---

# 好任务五要素

<div class="mt-8 text-center">
<div class="inline-block p-4 rounded-xl bg-blue-500/10 border border-blue-500/30 px-8 text-lg font-bold">
好任务 = 目标 + 范围 + 约束 + 输出格式 + 验收标准
</div>
</div>

<!--
一个合格的 AI 编程任务，必须包含五要素。
目标：到底要分析或修改什么。
范围：只看哪些模块，不看哪些模块。
约束：不能做什么，必须遵守什么。
输出格式：报告、表格、代码 diff、测试用例。
验收标准：什么结果算合格。
这五项越清楚，AI 输出越稳定。
-->

---

# 若依坏 Prompt 示例

<div class="mt-6 p-4 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">

```
@workspace 帮我检查若依权限有没有问题。
```

问题：权限包含页面权限、按钮权限、接口权限、数据权限。"有没有问题"太泛。
</div>

<!--
这个 Prompt 看起来合理，但其实太大。
“权限”包含页面权限、按钮权限、接口权限、数据权限。
“有没有问题”也太泛：是安全风险、实现缺陷、配置问题，还是调用链路不清？
没有范围，没有约束，没有输出格式，也没有验收标准。
-->

---

# 若依好 Prompt 示例

<div class="mt-4 p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">

```
@workspace 请分析若依"用户管理页面按钮权限"的调用链路。
范围：只分析用户管理页面的新增、修改、删除按钮权限。
约束：不修改代码；结论标注文件和函数；区分前端权限和后端接口权限。
输出：表格。
验收：覆盖按钮、权限字符、前端判断、后端接口、权限注解、不确定点。
```

</div>

<!--
这个 Prompt 就清楚很多。
目标是用户管理页面按钮权限，不是整个权限系统。
范围限定新增、修改、删除按钮。
约束要求不修改代码，结论标注文件和函数，区分前端权限和后端权限。
验收标准要求覆盖按钮、权限字符、前端判断、后端接口、权限注解和不确定点。
这就是合格任务。
-->

---

# 上下文组织清单

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

| 要素 | 说明 |
|------|------|
| 目标 | 到底要分析或修改什么 |
| 范围 | 只看哪些模块 |
| 输入文件 | 提供哪些文件 |
| 约束 | 不能做什么 |
| 输出格式 | 报告/表格/diff |
| 验收标准 | 什么结果算合格 |
| 不确定点 | 需要人工判断的 |

</div>

<!--
以后大家在若依项目里使用 TRAE，可以先填这张清单。
比如分析角色权限保存链路，需要提供角色页面、角色 API、后端角色 Controller、Service、菜单关系表、操作日志相关代码。
同时要约束 AI：不要改代码，不要猜，不要把按钮权限当安全边界。
-->