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
@@ -0,0 +1,33 @@
# MCP 工具权限与验收清单
## 接入前
- [ ] 已确认该能力确实需要 MCP,而非 CLI、Rule、任务上下文契约 或 Skill。
- [ ] 每个工具都有用途、输入、输出、副作用和错误语义说明。
- [ ] 已确认数据范围、鉴权、审计和脱敏要求。
- [ ] 未将密钥、Token、账号、完整个人信息或内部地址写入配置、示例或日志。
- [ ] 已明确只读、可逆写入和不可逆操作,未根据工具名称猜测性质。
## Agent 授权
- [ ] 每个自定义 Agent 只绑定完成职责所需的 MCP 工具。
- [ ] 读取受限信息时,调用身份和数据范围可被 MCP 服务校验。
- [ ] 写入、删除、发布和外发操作不属于通用 Agent 默认权限。
- [ ] 有副作用操作具备二次确认、幂等或明确的重复调用处理。
- [ ] Agent 在 MCP 失败时输出“外部事实未取得”,不编造结果。
## 验收夹具
- [ ] 合法完整请求:返回结构、来源时间和范围符合契约。
- [ ] 缺少必填参数:拒绝并指出缺口。
- [ ] 越权请求:拒绝或触发确认,不泄露超范围数据。
- [ ] 鉴权失败、限流、超时和服务错误:错误类型可区分。
- [ ] 返回空结果:与工具故障明确区分。
- [ ] 敏感字段:按契约脱敏,审计日志不暴露秘密信息。
- [ ] 重复调用:符合幂等设计或被安全阻止。
## 结论
- [ ] 可接入:契约、权限、审计、失败处理和验收夹具完整。
- [ ] 待确认:记录缺失的外部规范或验证材料。
- [ ] 不接入:说明改用 CLI、Skill 或人工流程的原因。
@@ -0,0 +1,34 @@
# MCP 能力契约
## 基本信息
| 字段 | 内容 |
|---|---|
| 服务名称 | `<名称>` |
| 接入目的 | `<要解决的外部事实或操作>` |
| 适用场景 | `<何时允许使用>` |
| 不适用场景 | `<何时不得使用>` |
| 来源依据 | `<接口文档、系统规范或已验证记录>` |
## 工具清单
| 工具 | 用途 | 输入契约 | 输出契约 | 副作用 | 权限与确认 | 错误语义 | 审计与脱敏 |
|---|---|---|---|---|---|---|---|
| `<tool>` | `<用途>` | `<必填、格式、范围>` | `<字段、时效、空值>` | `只读 / 可逆写入 / 不可逆` | `<调用资格与确认>` | `<鉴权、限流、超时等>` | `<留痕字段与脱敏规则>` |
## Agent 绑定边界
- 允许调用的自定义 Agent:`<名称或角色>`。
- 不允许调用的 Agent:`<名称或角色>`。
- Agent 调用前必须具备的运行时事实:`<数据范围、目标对象、确认信息>`。
- Agent 调用后必须输出:`<来源、时间、结果、失败或待确认>`。
## 停止与降级
| 情况 | MCP 或 Agent 的行为 |
|---|---|
| 缺少关键输入 | 拒绝调用并列出字段缺口 |
| 鉴权或数据范围不满足 | 拒绝调用,不尝试扩大权限 |
| 限流、超时或服务不可用 | 区分故障类型,标记外部事实未取得 |
| 有副作用但未确认 | 停止并请求确认 |
| 返回敏感信息 | 按规则脱敏,避免写入任务记录或日志 |
@@ -0,0 +1,29 @@
# MCP 能力资产包
本目录用于沉淀可被 Agent 调用的外部能力边界,不保存任何服务地址、访问令牌、账号、内部域名或业务数据。
## 何时使用
- 需要跨系统读取经授权的事实、日志或文档。
- 需要调用具有结构化输入输出的外部工具。
- 需要将浏览器、数据库、内部平台或其他服务能力提供给 Agent。
## 不适用场景
- 已有稳定命令且不需要交互式工具调用的任务,优先使用 CLI。
- 只有知识、流程、模板或检查清单的任务,优先沉淀为 Rule、任务上下文契约或 Skill。
- 未确认数据范围、鉴权方式、审计要求或副作用的外部服务。
## 使用顺序
1. 使用 `MCP能力契约.template.md` 描述每个拟接入的服务与工具。
2. 使用 `MCP工具权限与验收清单.md` 审查权限、敏感数据、错误和副作用。
3. 为完整请求、缺参、越权、故障和脱敏结果准备验证夹具。
4. 只有契约与验收都满足时,才将对应工具分配给自定义 Agent 或 Skill。
## 基本原则
- 不根据工具名称推断只读或安全性。
- 外部工具失败时,结论必须标记为“外部事实未取得”。
- 写入、删除、发布和外发能力不应作为通用 Agent 的默认权限。
- 日志、示例和夹具不得包含密钥、Token、账号、完整个人信息或内部地址。