docs: 更新TRA编程培训课程材料、课件与AI技能交付包
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
This commit is contained in:
smart
@@ -0,0 +1,195 @@
|
||||
# 模块 8：资产变更也要走工程验证
|
||||
|
||||
<div class="mt-6 text-sm">
|
||||
|
||||
代码变更会进入 Review、测试和 CI；会影响 Agent 行为的资产变更也应接受同样严肃的验证。
|
||||
|
||||
Rule、任务上下文契约、Skill、自定义 Agent 和 MCP 契约不是静态文档，而是研发过程中的可执行配置。
|
||||
|
||||
</div>
|
||||
|
||||
<div class="grid grid-cols-5 gap-3 mt-8 text-sm">
|
||||
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">Rule</div>
|
||||
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">上下文契约</div>
|
||||
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">Skill</div>
|
||||
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">Agent</div>
|
||||
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">MCP</div>
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：第五天验证的是一份资产自身是否有清晰边界：材料齐全时怎样交付，材料缺失时能否正确停止。模块 5 管理共享版本、使用者迁移与稳定回退点。这里聚焦一条资产 diff：实际行为改了什么，引用是否仍可用，代表性边界是否重新验证，证据是否能进入审查记录。
|
||||
|
||||
第五天建立资产的内容与边界；模块 5 管理版本生命周期；模块 8 审查本次资产变更的行为与证据。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 为什么资产变更会改变行为？
|
||||
|
||||
<div class="mt-5 text-xs">
|
||||
|
||||
| 改动位置 | 直接影响 | 需要防范的风险 |
|
||||
|---|---|---|
|
||||
| Rule 的必须与禁止项 | 任务允许做什么、何时停止 | 放宽关键约束或误伤正常任务 |
|
||||
| 任务上下文契约的输入与输出 Schema | 模型可依据什么、结果如何被消费 | 事实缺失、下游解析失效 |
|
||||
| Skill 的步骤与引用 | 判断顺序、加载的资产和交接结果 | 漏掉验证步骤或引用旧资产 |
|
||||
| Agent 的指令与工具 | 角色职责、可调用能力和权限 | 越权、职责重叠或不可控输出 |
|
||||
| MCP 的能力契约 | 外部读写范围与失败语义 | 把高风险调用当成只读查询 |
|
||||
|
||||
</div>
|
||||
|
||||
<div class="mt-6 p-3 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
|
||||
审查资产 diff 的重点，是行为变化，而不是措辞是否顺畅。
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：资产文件看起来像文档或配置，但它们会直接改变 Agent 的输入、判断、输出和工具权限。因此审查资产 diff 的重点不是语句是否顺畅，而是行为发生了什么变化。删除一个输入字段、放宽一条 Rule、增加一个工具，都可能扩大不可靠结论或越权调用的风险。
|
||||
|
||||
资产可以是 Markdown 或配置文件，但应按其对任务行为的影响来审查。不同资产对应的风险层次不同。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 资产变更审查的四个问题
|
||||
|
||||
<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>
|
||||
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">名称、路径、引用和元数据仍能正确解析吗？</div>
|
||||
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">实际行为变化与本次变更目的一致吗？</div>
|
||||
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">完整、缺失、冲突和越界输入都重新验证了吗？</div>
|
||||
</div>
|
||||
|
||||
<div class="mt-7 text-sm text-center op-75">
|
||||
四个问题覆盖语义、引用、变更意图与边界验证。
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：审查一次资产变更时，可以从四个方向提问。输入、输出、停止条件和权限变了吗；名称、路径和引用还能解析吗；实际变化是否真的解决了本次问题；完整、缺失、冲突与越界输入是否重新验证。版本兼容、迁移和回退已经在模块 5 中定义，这里不重复讨论。
|
||||
|
||||
这四个问题能避免只看正文不看引用关系，也能避免只跑正常示例而忽略停止条件和权限边界。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 用测试夹具做资产回归
|
||||
|
||||
<div class="mt-5 text-xs">
|
||||
|
||||
| 夹具类型 | 输入特征 | 预期行为 |
|
||||
|---|---|---|
|
||||
| 完整输入 | 事实、规则和验证材料齐全 | 输出结构完整，结论能关联证据 |
|
||||
| 缺失输入 | 缺少关键代码、日志或规则 | 明确列出缺口并停止结论 |
|
||||
| 冲突输入 | 需求、规则和实现信息不一致 | 标识冲突，不擅自选择一方 |
|
||||
| 越界输入 | 请求超出定义的项目或权限范围 | 拒绝越界操作，解释允许范围 |
|
||||
|
||||
</div>
|
||||
|
||||
<div class="mt-6 p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">
|
||||
资产回归验证边界是否正确，不要求模型每次生成完全相同的文字。
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：资产回归使用夹具，而不是要求模型每次输出相同句子。完整输入验证能否形成有证据的交付，缺失输入验证能否停止，冲突输入验证能否标识分歧，越界输入验证能否拒绝。我们断言的是结构、边界和结论等级；历史版本的迁移与降级属于模块 5 的版本治理。
|
||||
|
||||
夹具是可重复的输入与预期行为组合。对于生成式资产，更稳定的断言是结构、边界和结论等级，而不是逐字比对输出。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 修改前后都要检查引用完整性
|
||||
|
||||
<div class="mt-5 text-xs">
|
||||
|
||||
| 检查对象 | 典型问题 | 验证方式 |
|
||||
|---|---|---|
|
||||
| Skill 元数据 | 名称、触发描述、入口路径失效 | 读取目录与发现配置 |
|
||||
| Rule 与任务上下文契约引用 | 指向旧路径、旧字段或旧版本 | 搜索引用并运行代表性任务 |
|
||||
| Agent 调用 Skill | 角色名或交接 Schema 改变 | 检查调用参数与结构化输出 |
|
||||
| MCP 工具契约 | 工具名、读写标记、错误语义不一致 | 契约校对与权限夹具 |
|
||||
| 下游交付模板 | 新输出字段未被消费或旧字段仍被依赖 | 对照输入输出 Schema |
|
||||
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：资产变更最常见的问题往往不是正文写错，而是引用链断了。Skill 的发现元数据、Rule 和任务上下文契约的路径、Agent 的交接字段、MCP 的工具语义、下游模板的 Schema，都相当于接口。修改前后都要检查这些名称、路径、字段和调用关系是否仍能正确工作。
|
||||
|
||||
资产改动常见故障不是正文写错，而是引用链断裂。应把路径、名称、字段和调用关系视为需要验证的接口。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 三类不能直接合入的资产变更
|
||||
|
||||
<div class="mt-5 text-xs">
|
||||
|
||||
| 信号 | 风险 | 需要补齐的内容 |
|
||||
|---|---|---|
|
||||
| 新增工具权限，却没有用途和停止边界 | Agent 可能越权调用外部能力 | 权限说明、允许场景和失败降级 |
|
||||
| 修改必填输入或输出结构，却没有代表性夹具 | 行为变化无法被回归判断 | 覆盖正常、缺失与冲突材料的验证记录 |
|
||||
| 更新规则或任务上下文契约，却没有代表性夹具 | 无法判断是修复还是引入新误用 | 完整、缺失、冲突和越界输入验证 |
|
||||
|
||||
</div>
|
||||
|
||||
<div class="mt-6 p-3 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
|
||||
没有行为说明、引用检查和验证证据的资产 diff，不具备合入条件。
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：三类资产改动不能直接合入：新增工具权限却没有用途和停止边界，修改输入或输出却没有迁移说明，更新规则或任务上下文契约却没有代表性夹具。它们缺的不是表面流程，而是行为说明、兼容边界和验证证据。补齐这些证据之后，才知道改动是在修复问题还是引入新的误用。
|
||||
|
||||
这三类信号对 Rule、任务上下文契约、Skill、Agent 和 MCP 都适用。重点是补齐证据，不是形式化地增加审批步骤。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 资产变更的最小交付说明
|
||||
|
||||
<div class="mt-5 text-xs">
|
||||
|
||||
```md
|
||||
## 变更目的
|
||||
解决的重复问题、误用风险或项目事实变化。
|
||||
|
||||
## 行为变化
|
||||
输入、输出、约束、工具权限、停止条件中发生了什么变化。
|
||||
|
||||
## 变更范围与引用结果
|
||||
受影响的文件、调用方、模板或配置，以及名称、路径和 Schema 的检查结果。
|
||||
|
||||
## 验证证据
|
||||
已运行的夹具、引用检查和可复核结果；未覆盖项如实列出。
|
||||
```
|
||||
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：资产变更也需要一份最小交付说明。先说明为什么改，再说明输入、输出、权限或停止条件改变了什么，随后列出受影响的引用及检查结果，最后附上已运行的夹具和可复核证据。它可以随资产 diff 或 PR 保存，让后续维护者无需从修改记录中反推行为变化。
|
||||
|
||||
这份说明记录本次资产 diff 的工程证据。模块 5 的版本兼容性说明则记录目标版本的适用范围、迁移与回退，两者分别服务于变更审查和版本使用。
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
# 资产也纳入工程质量闭环
|
||||
|
||||
<div class="mt-7 text-sm text-center">
|
||||
|
||||
<div class="inline-block px-4 py-2 rounded-lg bg-blue-500/10 border border-blue-500/30">识别行为变化</div>
|
||||
<span class="mx-2 op-50">-></span>
|
||||
<div class="inline-block px-4 py-2 rounded-lg bg-emerald-500/10 border border-emerald-500/30">检查引用与解析结果</div>
|
||||
<span class="mx-2 op-50">-></span>
|
||||
<div class="inline-block px-4 py-2 rounded-lg bg-amber-500/10 border border-amber-500/30">验证夹具与权限边界</div>
|
||||
<span class="mx-2 op-50">-></span>
|
||||
<div class="inline-block px-4 py-2 rounded-lg bg-purple-500/10 border border-purple-500/30">留下可追溯结论</div>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="mt-9 text-sm text-center op-75">
|
||||
代码和 AI 工程资产都需要以事实、边界和验证作为进入共享使用的依据。
|
||||
</div>
|
||||
|
||||
<!--
|
||||
逐字稿：资产进入共享使用前，也要走完整的工程质量闭环。先识别行为变化，再检查引用和解析结果，然后验证夹具与权限边界，最后留下可追溯结论。代码验证的是实现结果，AI 工程资产验证的是判断、权限和引用是否仍然可靠。
|
||||
|
||||
资产变更与代码变更采用相同的质量原则，但验证对象不同：代码验证行为实现，资产验证判断、权限和引用是否仍然可靠。
|
||||
-->
|
||||
Reference in New Issue
Block a user