smart
9.7 KiB
9.7 KiB
第 1 天到第 2 天
第 1 天： 让 TRAE 看懂若依代码
第 2 天： 让 TRAE 按团队规则改若依代码
核心变化：从代码理解到研发治理
若依场景下的团队规则问题
若依类后台项目常见风险：
- 绕过权限，页面直接调接口
- 按钮权限当安全边界
- 接口缺少权限注解
- 操作日志缺失
- 代码生成后直接上线
- 敏感信息进入日志
今天三个关键词
🎯
上下文
决定 AI 看什么
📏
规则
决定 AI 怎么做
📦
资产化
决定团队怎么复用
第 2 天训练主线
1. 组织上下文
把任务、范围、文件和验收讲清楚
2. 收集证据
让 TRAE 先找文件、函数、注解和调用链
3. 写成 rules
把隐性要求变成可执行约束
4. 资产化复用
沉淀 Prompt、清单、模板和验收标准
课堂总产出：围绕若依“用户管理删除权限”完成一次证据审查，并产出一版可落地的
.trae/rules.md v0.1。
模块 1：若依任务为什么要讲清楚？
模糊任务： 帮我优化用户管理模块
问题： 目标不清 · 范围不清 · 约束不清 · 输出不清 · 验收不清
好任务五要素
好任务 = 目标 + 范围 + 约束 + 输出格式 + 验收标准
贯穿案例：用户管理删除权限审查
业务动作
管理员在用户管理页面删除用户。
前端按钮、接口调用、后端权限、操作日志都会被牵连。
训练目标
让 TRAE 不凭印象判断，而是按证据给出风险、修改建议和验证方式。
| 审查点 | 必须找到的证据 |
|---|---|
| 前端按钮 | 页面路径、权限字符、按钮显示判断 |
| 后端接口 | Controller 方法、权限注解、请求路径 |
| 操作审计 | 日志注解、操作类型、异常路径 |
| 验证方式 | 无权限账号、正常账号、日志查询 |
若依坏 Prompt 示例
@workspace 帮我检查若依权限有没有问题。
问题：权限包含页面权限、按钮权限、接口权限、数据权限。"有没有问题"太泛。
若依好 Prompt 示例
@workspace 请分析若依"用户管理页面按钮权限"的调用链路。
范围：只分析用户管理页面的新增、修改、删除按钮权限。
约束：不修改代码；结论标注文件和函数；区分前端权限和后端接口权限。
输出：表格。
验收：覆盖按钮、权限字符、前端判断、后端接口、权限注解、不确定点。
上下文包模板
任务：审查若依用户管理删除权限是否完整
范围：用户管理页面、用户 API、后端用户 Controller/Service、操作日志相关代码
不做：不要修改代码；不要输出泛泛安全建议；不要猜测未看到的实现
必须标注：文件路径、函数/方法名、权限字符、注解、无法确认项
输出：证据表 + 风险判断 + 修改建议 + 验证步骤
验收：至少覆盖前端按钮、后端接口、权限注解、操作日志、无权限访问验证
上下文组织清单
| 要素 | 说明 |
|---|---|
| 目标 | 到底要分析或修改什么 |
| 范围 | 只看哪些模块 |
| 输入文件 | 提供哪些文件 |
| 约束 | 不能做什么 |
| 输出格式 | 报告/表格/diff |
| 验收标准 | 什么结果算合格 |
| 不确定点 | 需要人工判断的 |