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