feat(day2): 更新课件

This commit is contained in:
smart
2026-06-12 18:25:01 +08:00
parent bbe619d386
commit 4e1829fa08
12 changed files with 762 additions and 17 deletions
+92 -1
View File
@@ -38,7 +38,7 @@
<!--
若依这类后台系统,最容易出现的问题不是页面不好看,而是权限、日志、接口边界和生成代码质量。
AI 可能在页面里直接新增接口调用;只做前端按钮隐藏;没有检查后端权限注解;新增敏感操作但没有操作日志;用代码生成器生成 CRUD 后直接上线。
今天要把这些隐性开发要求写成中文规则,让 TRAE 在后续协作中长期遵守。
今天要把这些隐性开发要求写规则,让 TRAE 在后续协作中长期遵守。
-->
---
@@ -72,6 +72,40 @@ AI 可能在页面里直接新增接口调用;只做前端按钮隐藏;没
---
# 第 2 天训练主线
<div class="grid grid-cols-4 gap-3 mt-6 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">
<div class="font-bold mb-1">1. 组织上下文</div>
<div class="text-xs text-gray-400">把任务、范围、文件和验收讲清楚</div>
</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
<div class="font-bold mb-1">2. 收集证据</div>
<div class="text-xs text-gray-400">让 TRAE 先找文件、函数、注解和调用链</div>
</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">
<div class="font-bold mb-1">3. 写成 rules</div>
<div class="text-xs text-gray-400">把隐性要求变成可执行约束</div>
</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">
<div class="font-bold mb-1">4. 资产化复用</div>
<div class="text-xs text-gray-400">沉淀 Prompt、清单、模板和验收标准</div>
</div>
</div>
<div class="mt-6 p-4 rounded-xl bg-white/5 border border-white/10 text-sm">
<strong>课堂总产出:</strong>围绕若依“用户管理删除权限”完成一次证据审查,并产出一版可落地的 <code>.trae/rules.md v0.1</code>。
</div>
<!--
第二天的训练不是单独讲规则,而是按真实工作流推进。
先把任务上下文讲清楚,再让 TRAE 收集证据,然后把证据转成规则,最后沉淀成团队资产。
今天我们用一个贯穿案例:用户管理删除权限。
学员最后要拿走的不只是 Prompt,而是一套能复用的 rules、检查清单和验收模板。
-->
---
# 模块 1:若依任务为什么要讲清楚?
<div class="mt-6 p-4 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
@@ -110,6 +144,39 @@ AI 可能在页面里直接新增接口调用;只做前端按钮隐藏;没
---
# 贯穿案例:用户管理删除权限审查
<div class="grid grid-cols-2 gap-5 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>
<div class="text-xs text-gray-400 mt-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>让 TRAE 不凭印象判断,而是按证据给出风险、修改建议和验证方式。</div>
</div>
</div>
<div class="mt-5 text-sm">
| 审查点 | 必须找到的证据 |
|---|---|
| 前端按钮 | 页面路径、权限字符、按钮显示判断 |
| 后端接口 | Controller 方法、权限注解、请求路径 |
| 操作审计 | 日志注解、操作类型、异常路径 |
| 验证方式 | 无权限账号、正常账号、日志查询 |
</div>
<!--
后面所有 Prompt 和 rules 都围绕同一个案例展开。
用户管理删除权限很适合教学,因为它同时涉及前端按钮权限、后端接口权限、操作日志和验证方式。
我们不是让 AI 泛泛讲安全,而是让它在这个动作上找证据。
-->
---
# 若依坏 Prompt 示例
<div class="mt-6 p-4 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
@@ -155,6 +222,30 @@ AI 可能在页面里直接新增接口调用;只做前端按钮隐藏;没
---
# 上下文包模板
<div class="mt-4 p-4 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">
```md
任务:审查若依用户管理删除权限是否完整
范围:用户管理页面、用户 API、后端用户 Controller/Service、操作日志相关代码
不做:不要修改代码;不要输出泛泛安全建议;不要猜测未看到的实现
必须标注:文件路径、函数/方法名、权限字符、注解、无法确认项
输出:证据表 + 风险判断 + 修改建议 + 验证步骤
验收:至少覆盖前端按钮、后端接口、权限注解、操作日志、无权限访问验证
```
</div>
<!--
这是今天反复使用的上下文包模板。
真实工作里,不要只把一句话丢给 AI。
先把任务、范围、不做什么、必须标注什么、输出格式和验收标准写清楚。
这能显著减少 AI 自由发挥。
-->
---
# 上下文组织清单
<div class="mt-6 text-sm">