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

- 新增全套考试卷、评估卷、参考答案与考试培训包模板
- 修正slidev培训课件:调整模块标题、链路图缩放,替换工单示例为通用业务对象
- 修正课堂红线表述为证据红线,将小组作业调整为个人作业要求
- 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块
- 整理AI工程技能交付包,迁移旧资产至客户专属交付包并统一术语
- 新增考试输出模板与TRAE使用记录文档
This commit is contained in:
smart
2026-08-08 11:00:36 +08:00
parent e7d6db93c3
commit 67837df8d0
169 changed files with 6618 additions and 2887 deletions
+124
View File
@@ -0,0 +1,124 @@
# 模块 1:AI 改动的工程闭环
<div class="mt-6 text-sm">
AI 辅助完成的代码,仍然要经过研发协作中的基本检验:范围清晰、变更可审查、结果可验证、结论可追溯。
这些工程要素共同约束 AI 改动的速度、质量与责任边界。
</div>
<div class="mt-8 text-sm">
```text
影响分析
-> 变更实现
-> PR 说明
-> Git 审查与合并
-> CI 构建与测试
-> 发布或回退判断
-> 可追溯技术结论
```
</div>
<!--
逐字稿:第六天不再讨论如何让 AI 生成更多代码,而是讨论一段 AI 改动怎样进入研发交付。前面的影响分析、测试安全网和回退判断,会在这里连接成一条可审查、可验证、可追溯的工程链路。每个环节都要留下能够支撑下一步判断的技术信息。
第六天不再介绍新的工具按钮,而是把前面形成的影响分析、问题定位、测试安全网和回滚判断放回工程交付的完整语境。
这条链路强调每一步输出什么技术信息:影响分析限制范围,变更实现落实规则,PR 提供审查上下文,Git 保存历史,CI 补充自动化验证,最后留下准确的技术结论。它描述的是工程质量要求,不预设任何组织安排。
-->
---
# CI/CD 在交付链路中的位置
<div class="grid grid-cols-3 gap-3 mt-6 text-sm">
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">
<div class="font-bold">CI:持续集成</div>
<div class="mt-2 text-xs op-70">代码提交后自动编译、检查和测试,尽早发现无法合入的问题。</div>
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
<div class="font-bold">持续交付</div>
<div class="mt-2 text-xs op-70">CI 通过后形成可部署版本,进入测试或预生产环境;生产发布仍需人工确认。</div>
</div>
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">
<div class="font-bold">持续部署</div>
<div class="mt-2 text-xs op-70">CI 通过后自动发布生产环境,需要成熟的监控、自动化门禁和回退能力。</div>
</div>
</div>
<div class="mt-8 text-sm text-center">
提交 PR <span class="op-50">-&gt;</span> CI 构建与测试 <span class="op-50">-&gt;</span> 可部署版本 <span class="op-50">-&gt;</span> 测试环境验证 <span class="op-50">-&gt;</span> 人工确认 <span class="op-50">-&gt;</span> 生产发布或回退
</div>
<div class="mt-6 p-3 rounded-xl bg-slate-500/10 border border-slate-500/30 text-xs">
CI 负责尽早暴露问题;是否发布仍需要结合业务风险和验证证据作出判断。
</div>
<!--
逐字稿:CI 的全称是持续集成,代码进入协作链路后,它自动执行编译、检查和测试,尽早暴露不能合入的问题。CD 需要区分持续交付和持续部署:前者形成可部署版本并保留人工发布判断,后者才是自动发布生产环境。无论采用哪种方式,CI 通过都只是发布判断的一份证据。
CI 是持续集成,关注代码进入协作链路后能否正常构建、检查和测试。第六天的 CI 日志分析会围绕这个环节展开。
CD 在不同语境中可能指持续交付或持续部署。持续交付侧重形成可部署版本,生产发布保留人工确认;持续部署则会自动发布生产环境。两者的差异是生产发布是否自动发生。
-->
---
# AI 改动进入协作后的四类信息
<div class="grid grid-cols-2 gap-4 mt-8 text-sm">
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">
改动目标
<div class="mt-2 text-xs op-70">解决什么问题,明确不解决什么问题</div>
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
影响范围
<div class="mt-2 text-xs op-70">涉及哪些入口、数据、状态、权限或外部依赖</div>
</div>
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">
验证证据
<div class="mt-2 text-xs op-70">哪些行为已经由测试、日志或人工检查证实</div>
</div>
<div class="p-4 rounded-xl bg-purple-500/10 border border-purple-500/30">
已知边界
<div class="mt-2 text-xs op-70">哪些场景尚未覆盖,哪些结论仍需要确认</div>
</div>
</div>
<!--
逐字稿:AI 参与过的上下文不能只停留在对话窗口。进入协作后,至少要把改动目标、影响范围、验证证据和已知边界写清楚。这样评审、排障和后续维护的人才能基于同一组事实继续判断,而不是重新猜测改动意图。
AI 生成代码时,关键上下文很容易只留在对话窗口中。进入协作链路后,至少需要把改动目标、影响范围、验证证据和已知边界说清楚。
这四类信息不是额外文书,而是代码评审、CI 排障和后续维护能够进行准确判断的前提。
-->
---
# 工程质量的最终责任仍在人
<div class="mt-5 text-xs">
| AI 可以加速 | 人必须确认 |
|---|---|
| 搜索代码、归纳调用链、生成候选实现 | 业务规则是否正确 |
| 生成测试草稿、解释日志、提出修复假设 | 权限、数据和状态边界是否完整 |
| 补充 PR 说明和变更摘要 | 变更范围是否可接受,验证结论是否准确 |
| 提供多种实现方案 | 采用哪一种方案及其长期维护成本 |
</div>
<div class="mt-6 p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">
把 AI 当作加速器,而不是把工程判断外包给 AI。
</div>
<!--
逐字稿:AI 可以快速搜索代码、生成候选实现、起草测试和解释日志,但这些都是辅助判断的材料。业务规则是否正确、权限和数据边界是否完整、变更是否可以合入,仍然需要由人根据证据确认。把 AI 当作加速器,不能把工程责任交给 AI。
这一页给出边界:AI 擅长生成候选、归纳信息和补齐重复劳动;但业务规则、权限和数据安全、范围取舍与交付结论必须由人确认。
后续模块将从 PR、Git、CI、资产和可维护性几个角度具体说明如何保留这种判断能力。
-->