# 安装说明

## 方式一：安装到 TRAE Skills 目录

把 `skills/` 下的 5 个 Skill 文件夹复制到本机 Skills 目录：

```text
~/.trae/skills/
```

安装后目录应类似：

```text
~/.trae/skills/
├── project-knowledge-builder/
├── generate-project-constraints/
├── design-complex-business-module/
├── review-business-delivery/
└── track-review-fix-loop/
```

每个 Skill 文件夹必须保留完整结构：

```text
skill-name/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── assets/
```

## 调用方式

在支持 Skill 的 AI 编程工具中，可以这样调用：

```text
Use $generate-project-constraints 为当前项目生成 AI 开发约束。
Use $project-knowledge-builder 为当前项目生成 docs/project-knowledge 项目知识库。
Use $design-complex-business-module 设计这个业务模块的权限、状态、审计、异常态和看板。
Use $review-business-delivery Review 这批阶段交付物。
Use $track-review-fix-loop 根据 Review 报告生成修复闭环记录。
```

## 方式二：作为团队资产库使用

如果当前 AI 工具暂不支持原生 Skill 机制，可以把本包作为团队资产库使用：

```text
ai-engineering-assets/
├── skills/
├── rules/
├── prompts/
├── templates/
├── checklists/
└── examples/
```

此时 `SKILL.md` 作为标准工作流说明，`assets/` 作为可复制模板、Prompt、检查清单和反例库。

`examples/` 目录只用于学习参考，不要复制到通用 Skills 安装目录。换项目复用时，应先用 `project-knowledge-builder` 建立项目知识库，再用 `generate-project-constraints` 重新扫描目标项目，最后使用其他 Skill 生成该项目自己的权限、状态、审计、Review 和修复闭环资产。

## 维护建议

- 每次项目规则变化后，重新运行 `generate-project-constraints`。
- 每次复杂业务模块交付后，把高频问题沉淀到 `review-business-delivery` 或 `track-review-fix-loop` 的 assets。
- 不要把某个项目的专用规则直接复制成通用规则。
- 对无法从源码或配置证明的内容，统一标记为待确认。