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
@@ -1,63 +1,56 @@
# 安装说明
## 方式一:安装到 TRAE Skills 目录
## 使用前确认
把 `skills/` 下的 4 个 Skill 文件夹复制到本机 Skills 目录:
本包不携带外部系统地址、账号、令牌或客户数据。请先在目标项目中确认 AI 工具的 Skill 加载方式、项目规则位置和访问权限,再决定安装范围。
```text
~/.trae/skills/
```
## 方式一:作为本地 Skill 目录使用
安装后目录应类似:
将 `skills/` 下需要启用的完整文件夹复制到当前 AI 编程工具配置的本地 Skill 目录。不同版本和不同工具的目录规则可能不同,应以当前客户端实际配置为准。
```text
~/.trae/skills/
├── generate-project-constraints/
├── design-complex-business-module/
├── review-business-delivery/
└── track-review-fix-loop/
```
每个 Skill 文件夹必须保留完整结构:
每个 Skill 必须保留原始目录结构:
```text
skill-name/
├── SKILL.md
├── agents/
│ └── openai.yaml
└── assets/
├── assets/ # 部分 Skill 提供
├── references/ # 部分 Skill 提供
└── scripts/ # 部分 Skill 提供
```
## 调用方式
推荐启用顺序:
在支持 Skill 的 AI 编程工具中,可以这样调用:
```text
Use $generate-project-constraints 为当前项目生成 AI 开发约束。
Use $design-complex-business-module 设计这个业务模块的权限、状态、审计、异常态和看板。
Use $review-business-delivery Review 这批阶段交付物。
Use $track-review-fix-loop 根据 Review 报告生成修复闭环记录。
```
1. `generate-project-constraints`:先获取项目约束。
2. `project-knowledge-builder`:建立项目地图和可检索知识。
3. `design-complex-business-module`:设计权限、状态、审计等高风险边界。
4. `review-business-delivery`:审查设计、代码或 PR。
5. `track-review-fix-loop`:跟踪修复、验证与资产更新。
## 方式二:作为团队资产库使用
如果当前 AI 工具暂不支持原生 Skill 机制,可以把本包作为团队资产库使用:
如果当前工具不支持原生 Skill 发现,可将本包纳入团队资产库。保留目录结构,并让任务上下文契约或 Agent 明确引用对应文件。
```text
ai-engineering-assets/
├── skills/
├── rules/
├── prompts/
├── templates/
├── checklists/
├── mcp-assets/
└── examples/
```
此时 `SKILL.md` 作为标准工作流说明,`assets/` 作为可复制模板、Prompt、检查清单和反例库。
其中 `SKILL.md` 负责输入、工作流、输出契约和停止条件;`assets/` 存放模板、任务上下文契约、检查单和反例;`mcp-assets/` 负责外部能力的契约、权限与验收边界。
## 维护建议
## MCP 资产的使用
- 每次项目规则变化后,重新运行 `generate-project-constraints`。
- 每次复杂业务模块交付后,把高频问题沉淀到 `review-business-delivery` 或 `track-review-fix-loop` 的 assets。
- 不要把某个项目的专用规则直接复制成通用规则。
- 对无法从源码或配置证明的内容,统一标记为待确认。
1. 使用 `mcp-assets/MCP能力契约.template.md` 描述每项待接入能力。
2. 使用 `mcp-assets/MCP工具权限与验收清单.md` 审查数据范围、权限、副作用和故障降级。
3. 为完整请求、缺参、越权、超时和敏感字段准备验证夹具。
4. 只有契约与验证完整后,才把工具授权给对应 Agent。
## 维护要求
- 项目规则、框架、接口、权限或测试基座变化后,重新取证并更新相关资产。
- 不要将示例中的业务对象、路径、字段、接口、状态或验证结论复制到其他项目。
- 资产变更需要说明行为变化、兼容边界、迁移方式、回退条件和验证证据。
- 对无法证明的内容保留为待确认,不以经验或模型建议替代事实。