smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# 安装说明
|
|
|
|
## 使用前确认
|
|
|
|
本包不携带外部系统地址、账号、令牌或客户数据。请先在目标项目中确认 AI 工具的 Skill 加载方式、项目规则位置和访问权限，再决定安装范围。
|
|
|
|
## 方式一：作为本地 Skill 目录使用
|
|
|
|
将 `skills/` 下需要启用的完整文件夹复制到当前 AI 编程工具配置的本地 Skill 目录。不同版本和不同工具的目录规则可能不同，应以当前客户端实际配置为准。
|
|
|
|
每个 Skill 必须保留原始目录结构：
|
|
|
|
```text
|
|
skill-name/
|
|
├── SKILL.md
|
|
├── agents/
|
|
│ └── openai.yaml
|
|
├── assets/ # 部分 Skill 提供
|
|
├── references/ # 部分 Skill 提供
|
|
└── scripts/ # 部分 Skill 提供
|
|
```
|
|
|
|
推荐启用顺序：
|
|
|
|
1. `generate-project-constraints`：先获取项目约束。
|
|
2. `project-knowledge-builder`：建立项目地图和可检索知识。
|
|
3. `design-complex-business-module`：设计权限、状态、审计等高风险边界。
|
|
4. `review-business-delivery`：审查设计、代码或 PR。
|
|
5. `track-review-fix-loop`：跟踪修复、验证与资产更新。
|
|
|
|
## 方式二：作为团队资产库使用
|
|
|
|
如果当前工具不支持原生 Skill 发现，可将本包纳入团队资产库。保留目录结构，并让任务上下文契约或 Agent 明确引用对应文件。
|
|
|
|
```text
|
|
ai-engineering-assets/
|
|
├── skills/
|
|
├── mcp-assets/
|
|
└── examples/
|
|
```
|
|
|
|
其中 `SKILL.md` 负责输入、工作流、输出契约和停止条件；`assets/` 存放模板、任务上下文契约、检查单和反例；`mcp-assets/` 负责外部能力的契约、权限与验收边界。
|
|
|
|
## MCP 资产的使用
|
|
|
|
1. 使用 `mcp-assets/MCP能力契约.template.md` 描述每项待接入能力。
|
|
2. 使用 `mcp-assets/MCP工具权限与验收清单.md` 审查数据范围、权限、副作用和故障降级。
|
|
3. 为完整请求、缺参、越权、超时和敏感字段准备验证夹具。
|
|
4. 只有契约与验证完整后，才把工具授权给对应 Agent。
|
|
|
|
## 维护要求
|
|
|
|
- 项目规则、框架、接口、权限或测试基座变化后，重新取证并更新相关资产。
|
|
- 不要将示例中的业务对象、路径、字段、接口、状态或验证结论复制到其他项目。
|
|
- 资产变更需要说明行为变化、兼容边界、迁移方式、回退条件和验证证据。
|
|
- 对无法证明的内容保留为待确认，不以经验或模型建议替代事实。
|