docs: 更新TRA编程培训课程材料、课件与AI技能交付包
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件:调整模块标题、链路图缩放,替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线,将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包,迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
This commit is contained in:
@@ -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。
|
||||
|
||||
## 维护要求
|
||||
|
||||
- 项目规则、框架、接口、权限或测试基座变化后,重新取证并更新相关资产。
|
||||
- 不要将示例中的业务对象、路径、字段、接口、状态或验证结论复制到其他项目。
|
||||
- 资产变更需要说明行为变化、兼容边界、迁移方式、回退条件和验证证据。
|
||||
- 对无法证明的内容保留为待确认,不以经验或模型建议替代事实。
|
||||
|
||||
Reference in New Issue
Block a user