# 安装说明

## 使用前确认

本包不携带外部系统地址、账号、令牌或客户数据。请先在目标项目中确认 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。

## 维护要求

- 项目规则、框架、接口、权限或测试基座变化后，重新取证并更新相关资产。
- 不要将示例中的业务对象、路径、字段、接口、状态或验证结论复制到其他项目。
- 资产变更需要说明行为变化、兼容边界、迁移方式、回退条件和验证证据。
- 对无法证明的内容保留为待确认，不以经验或模型建议替代事实。