Files
TARE-Learn/slidev/pages/day2/m1-context-engineering.md
smart 67837df8d0 docs: 更新TRA编程培训课程材料、课件与AI技能交付包
- 新增全套考试卷、评估卷、参考答案与考试培训包模板
- 修正slidev培训课件:调整模块标题、链路图缩放,替换工单示例为通用业务对象
- 修正课堂红线表述为证据红线,将小组作业调整为个人作业要求
- 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块
- 整理AI工程技能交付包,迁移旧资产至客户专属交付包并统一术语
- 新增考试输出模板与TRAE使用记录文档
2026-08-08 11:00:36 +08:00

9.7 KiB

从项目理解到研发治理

项目理解: 让 TRAE 看懂若依代码

研发治理: 让 TRAE 按团队规则改若依代码

从项目事实到可执行规则


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

若依类后台项目常见风险:

  • 绕过权限,页面直接调接口
  • 按钮权限当安全边界
  • 接口缺少权限注解
  • 操作日志缺失
  • 代码生成后直接上线
  • 敏感信息进入日志

上下文、规则与资产

🎯
上下文
决定 AI 看什么
📏
规则
决定 AI 怎么做
📦
资产化
决定团队怎么复用

上下文工程流程

1. 组织上下文
把任务、范围、文件和验收讲清楚
2. 收集证据
让 TRAE 先找文件、函数、注解和调用链
3. 写成 rules
把隐性要求变成可执行约束
4. 资产化复用
沉淀 Prompt、清单、模板和验收标准
任务产物:围绕若依“用户管理删除权限”完成证据审查,并形成可落地的 .trae/rules.md v0.1。

模块 1:任务上下文为什么必须明确?

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

问题: 目标不清 · 范围不清 · 约束不清 · 输出不清 · 验收不清


好任务五要素

好任务 = 目标 + 范围 + 约束 + 输出格式 + 验收标准

贯穿案例:用户管理删除权限审查

业务动作
管理员在用户管理页面删除用户。
前端按钮、接口调用、后端权限、操作日志都会被牵连。
训练目标
让 TRAE 不凭印象判断,而是按证据给出风险、修改建议和验证方式。
审查点 必须找到的证据
前端按钮 页面路径、权限字符、按钮显示判断
后端接口 Controller 方法、权限注解、请求路径
操作审计 日志注解、操作类型、异常路径
验证方式 无权限账号、正常账号、日志查询

若依坏 Prompt 示例

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

问题:权限包含页面权限、按钮权限、接口权限、数据权限。"有没有问题"太泛。


若依好 Prompt 示例

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

上下文包模板

任务:审查若依用户管理删除权限是否完整
范围:用户管理页面、用户 API、后端用户 Controller/Service、操作日志相关代码
不做:不要修改代码;不要输出泛泛安全建议;不要猜测未看到的实现
必须标注:文件路径、函数/方法名、权限字符、注解、无法确认项
输出:证据表 + 风险判断 + 修改建议 + 验证步骤
验收:至少覆盖前端按钮、后端接口、权限注解、操作日志、无权限访问验证

上下文组织清单

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