smart
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
# 安装说明
|
|
|
|
## 方式一：安装到 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。
|
|
- 不要把某个项目的专用规则直接复制成通用规则。
|
|
- 对无法从源码或配置证明的内容，统一标记为待确认。
|