Files

T

smart 67837df8d0 docs: 更新TRA编程培训课程材料、课件与AI技能交付包

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

2026-08-08 11:00:36 +08:00

10 KiB

Raw Blame History

复盘：六天能力图谱

六天内容只有一条主线：让 AI 参与研发时，团队如何持续获得事实、控制范围、验证行为，并把可靠经验沉淀下来。

看懂项目

组织上下文

处理复杂业务

沉淀团队资产

进入工程闭环

第 1 天：先把陌生项目变成可追溯的事实

学到的动作	不能跳过的原因	交付物
找模块、入口与关键对象	不知道系统在哪里，就无法讨论改动影响	模块认知图、项目结构图
追认证、路由、权限和日志链路	后台系统的风险常在跨层调用关系中	调用链路图
区分代码事实、业务事实与推断	AI 的流畅表达不等于项目真实行为	输出校验清单
写代码理解报告	让团队的理解可被交接和审查	代码理解报告

项目理解必须回到文件、函数、调用关系和不确定点，不能停在泛泛总结。

第 2 天：把一次会话变成可复用的上下文与规则

学到的动作	解决的问题	交付物
用目标、范围、约束、输出、验收组织任务	避免 AI 泛泛回答和无边界修改	上下文组织清单
组合 @workspace、#File、#Code、#Web	让检索从宽到窄、从事实到细节	上下文引用模板
先收集证据，再判断和给方案	切断幻觉和错误归因	证据收集 Prompt
编写安全、编码、测试与前端 Rule	让团队隐性习惯变成可执行约束	rules.md v0.1 与检查单

好规则不是“写得严格”，而是能说明何时触发、必须检查什么、不能做什么、如何验收。

第 3 天：从工具功能转向任务编排能力

学到的动作	关键判断	交付物
理解 Rule、Cue、模型和 Token 的位置	资源要匹配任务风险与信息复杂度	成本与任务匹配表
区分 Command、Skill、MCP 与 CLI	高频输入、多步决策和外部工具不是同一问题	能力封装决策表
设计 Agent 分工	输入、输出、验收和停止条件都要明确	Agent 分工表
使用 Browser、文档与 Plan	先计划、再执行、再记录验证	前端验证清单与 Plan 检查项

任务越复杂，越需要先把边界显式化，不能因为有 Agent 就跳过计划。

第 4 天：复杂业务先建立控制面，再讨论实现

业务难点	先产出的控制面	为什么不能直接生成代码
权限	RBAC 矩阵、页面/按钮/接口/数据范围方案	角色与数据范围是业务事实
状态	状态流转表、非法流转清单	允许和拒绝路径都必须明确
审计	字段表、前后值、SOP	“记录日志”不足以保证可追溯
异常态	前后端行为与最小测试集	正常流程跑通不代表业务安全
看板	指标字典、接口契约和验收	数字必须有口径、来源和权限范围

复杂业务最危险的顺序是“先让 AI 写代码，再回头补权限、状态和审计”。

第 5 天：把可靠判断沉淀为可维护资产

资产	适合保存什么	不应保存什么
Rule	长期稳定、违反代价高的约束	一次任务的临时路径和猜测
任务上下文契约	输入、输出、证据缺口和停止条件	没有来源的项目事实
Checklist / Template	固定遗漏点和稳定输出结构	所有判断逻辑的重复副本
Skill	多步骤、需要证据和验收的工作流	只有一句指令的简单需求
Agent / MCP	稳定角色、权限边界和外部能力	未声明读写性质的工具连接

资产化不是把聊天记录保存下来，而是把可复用的判断、边界和验证方式保存下来。

第 6 天：让 AI 改动进入真实工程闭环

工程环节	AI 可以辅助的工作	人必须负责的判断
PR 与 Git	归纳 Diff、生成说明、检查范围	改动是否该合入、如何回退
Review	发现风险、汇总证据缺口、生成问题草稿	问题是否成立、优先级与修复决策
CI	分类日志、关联配置与 Diff、建议验证命令	区分代码缺陷与环境处置
证据链	整理需求、实现、测试和边界	结论能否被当前证据支持
资产变更	检查引用、夹具和行为变化	权限和兼容性是否可接受

AI 产出必须进入已有的工程审查、验证和责任体系。

六项能力必须形成闭环

事实
代码、配置、日志和业务确认。

上下文
目标、范围、约束、输出和验收。

计划
影响范围、最小方案、风险和验证。

控制面
权限、状态、审计、异常和指标。

验证
测试、CI、浏览器和人工观察。

沉淀
PR、证据链、Rule、Skill 和资产库。

六天里最应该避免的六种误用

误用	正确替代动作
让 AI 泛泛总结整个项目	指定入口、问题、范围和证据格式
把模型回答当作业务规则	区分代码事实、业务确认、推断与待确认
直接接受大范围代码生成	先审阅 Plan，选择最小可验证 Diff
只隐藏前端按钮就认为有权限控制	验证页面、按钮、接口和数据范围四层边界
CI 变红就修改业务代码	先定位最早错误，区分代码、依赖、配置和环境
把一次有效 Prompt 直接升级为团队标准	先验证适用范围、停止条件和代表性夹具

最终交付不应只有代码

项目结构、调用链与事实记录

上下文包、Rule、Prompt 和检查单

权限、状态、审计、异常与指标控制面

Plan、Diff、测试、浏览器与 CI 证据

PR 说明、Review、修复记录和未覆盖边界

可验证、可维护、可演进的工程资产

代码是结果之一；可复用、可验证、可维护的工程资产，才能支撑长期协作。

10 KiB Raw Blame History