name: integrate-skill description: “集成技能到项目指南”
集成技能到项目指南
将可重用技能适配并集成到项目开发指南中（不直接集成到项目代码）。
使用
$integrate-skill <技能名称>
示例:
$integrate-skill 前端设计
$integrate-skill mcp构建器
核心原则
[!] 重要: 技能集成的目标是更新开发指南，而不是直接生成项目代码。
- 指南内容 -> 写入
.trellis/spec/{目标}/doc.md- 代码示例 -> 放置在
.trellis/spec/{目标}/examples/skills/<技能名称>/- 示例文件 -> 使用
.template后缀（例如component.tsx.template）以避免IDE错误其中
{目标}是前端或后端，由技能类型决定。
执行步骤
1. 读取技能内容
定位并读取技能指令：
- 仓库中的
.agents/skills/<技能名称>/SKILL.md AGENTS.md中的技能列表（当在当前上下文中可用时）
如果找不到技能，请向用户询问源路径或仓库。
2. 确定集成目标
基于技能类型，确定要更新的指南：
| 技能类别 | 集成目标 |
|---|---|
UI/前端 (前端设计, 网页构件构建器) |
.trellis/spec/frontend/ |
后端/API (mcp构建器) |
.trellis/spec/backend/ |
文档 (文档协作, docx, pdf) |
.trellis/ 或创建专门的指南 |
测试 (网页应用测试) |
.trellis/spec/frontend/ (端到端) |
3. 分析技能内容
从技能中提取：
- 核心概念: 技能如何工作及关键概念
- 最佳实践: 推荐的方法
- 代码模式: 可重用的代码模板
- 注意事项: 常见问题及解决方案
4. 执行集成
4.1 更新指南文档
在相应的 doc.md 中添加新部分：
@@@section:skill-<技能名称>
## # <技能名称> 集成指南
### 概述
[技能的核心功能和使用场景]
### 项目适配
[如何在当前项目中使用此技能]
### 使用步骤
1. [步骤1]
2. [步骤2]
### 注意事项
- [项目特定约束]
- [与默认行为的差异]
### 参考示例
参见 `examples/skills/<技能名称>/`
@@@/section:skill-<技能名称>
4.2 创建示例目录（如果存在代码示例）
# 目录结构 ({目标} = 前端 或 后端)
.trellis/spec/{目标}/
|-- doc.md # 添加技能相关部分
|-- index.md # 更新索引
+-- examples/
+-- skills/
+-- <技能名称>/
|-- README.md # 示例文档
|-- example-1.ts.template # 代码示例（使用 .template 后缀）
+-- example-2.tsx.template
文件命名约定:
- 代码文件:
<名称>.<扩展名>.template(例如component.tsx.template) - 配置文件:
<名称>.config.template(例如tailwind.config.template) - 文档:
README.md(正常后缀)
4.3 更新索引文件
在 index.md 的快速导航表中添加：
| <技能相关任务> | <部分名称> | `skill-<技能名称>` |
5. 生成集成报告
技能集成报告: <技能名称>
# 概述
- 技能描述: [功能描述]
- 集成目标:
.trellis/spec/{目标}/
# 技术栈兼容性
| 技能要求 | 项目状态 | 兼容性 |
|---|---|---|
| [技术1] | [项目技术] | [OK]/[!]/[X] |
# 集成位置
| 类型 | 路径 |
|---|---|
| 指南文档 | .trellis/spec/{目标}/doc.md (部分: skill-<名称>) |
| 代码示例 | .trellis/spec/{目标}/examples/skills/<名称>/ |
| 索引更新 | .trellis/spec/{目标}/index.md |
{目标}=前端或后端
# 依赖项（如果需要）
# 安装所需依赖项（根据包管理器调整）
npm install <包>
# 或
pnpm add <包>
# 或
yarn add <包>
[OK] 已完成更改
- [ ] 已添加
@@@section:skill-<名称>部分到doc.md - [ ] 已添加索引条目到
index.md - [ ] 已在
examples/skills/<名称>/创建示例文件 - [ ] 示例文件使用
.template后缀
# 相关指南
- [现有相关部分ID]
6. 可选：创建使用技能
如果此技能频繁使用，创建一个快捷技能：
$create-command use-<技能名称> 使用 <技能名称> 技能遵循项目指南
常见技能集成参考
| 技能 | 集成目标 | 示例目录 |
|---|---|---|
前端设计 |
前端 |
examples/skills/frontend-design/ |
mcp构建器 |
后端 |
examples/skills/mcp-builder/ |
网页应用测试 |
前端 |
examples/skills/webapp-testing/ |
文档协作 |
.trellis/ |
N/A（仅文档工作流） |
示例：集成 mcp构建器 技能
目录结构
.trellis/spec/backend/
|-- doc.md # 添加MCP部分
|-- index.md # 添加索引条目
+-- examples/
+-- skills/
+-- mcp构建器/
|-- README.md
|-- server.ts.template
|-- tools.ts.template
+-- types.ts.template
doc.md 中的新部分
@@@section:skill-mcp构建器
## # MCP 服务器开发指南
### 概述
使用MCP（模型上下文协议）创建LLM可调用的工具服务。
### 项目适配
- 将服务放置在专用目录中
- 遵循现有的TypeScript和类型定义约定
- 使用项目的日志系统
### 参考示例
参见 `examples/skills/mcp-builder/`
@@@/section:skill-mcp构建器