通用型 Skills 工程创建提示词

60 阅读6分钟

通用型 Skills 工程创建提示词

目标

创建一个完整的 Skills 工程,帮助开发团队在新项目中快速搭建 Claude Skills 体系,提高开发效率和代码质量。

适用场景

  • 新项目初始化时创建 Skills 工程
  • 现有项目添加 Skills 支持
  • 团队标准化开发流程
  • 提高 AI 辅助开发效率

前置条件

  • 已创建项目基本结构
  • 了解项目的核心功能和技术栈
  • 熟悉 Claude Skills 基本概念

提示词内容

作为一名专业的 AI Agent 工程师,请为我的新项目创建一个完整的 Skills 工程。

### 项目信息
- **项目名称**:[项目名称]
- **项目类型**:[前端/后端/全栈]
- **技术栈**:[列出主要技术栈,如 React+TypeScript 或 Python+FastAPI]
- **核心功能**:[简要描述项目核心功能]

### 要求

1. **创建完整的 Skills 目录结构**
   - 按照 Claude Skills 标准创建 `.trae/skills/` 目录
   - 包含 5-8 个核心 Skills
   - 每个 Skill 包含完整的 SKILL.md 文件
   - 包含示例脚本和资源(可选)

2. **核心 Skills 设计**
   - 项目初始化检查 Skill
   - 开发流程 Skill(前端/后端)
   - 代码质量检查 Skill
   - 测试执行 Skill
   - 构建部署 Skill
   - 调试排错 Skill
   - 文档生成 Skill
   - 项目特定 Skill(根据项目类型定制)

3. **SKILL.md 格式规范**
   - 包含 YAML 元数据(name 和 description)
   - 清晰的使用场景
   - 详细的操作步骤
   - 代码示例
   - 最佳实践
   - 常见问题

4. **渐进式披露设计**
   - 遵循三层加载机制
   - 元数据简洁明了
   - 指令详细完整
   - 资源按需引用

5. **团队协作友好**
   - 包含使用指南
   - 清晰的命名规范
   - 标准化的结构
   - 易于扩展和维护

### 交付物

1. **完整的 Skills 目录结构**
   .trae/
   └── skills/
       ├── README.md
       ├── project-init/
       │   └── SKILL.md
       ├── [其他 Skills]/
       │   └── SKILL.md
       └── ...

2. **Skills 使用文档**
   - 包含 Skills 列表和用途
   - 使用方法和流程
   - 最佳实践
   - 常见问题

3. **示例使用场景**
   - 开发前检查流程
   - 开发过程使用示例
   - 测试和构建流程
   - 部署和维护流程

### 参考资料

- Claude Skills 官方文档
- 项目的技术文档和架构设计
- 团队现有的开发流程和规范

请开始创建 Skills 工程,确保符合 Claude Skills 最佳实践,并根据项目类型进行定制。

使用方法

  1. 替换占位符

    • [项目名称] 替换为实际项目名称
    • [前端/后端/全栈] 替换为项目类型
    • [列出主要技术栈] 替换为项目的技术栈
    • [简要描述项目核心功能] 替换为项目核心功能
  2. 调整 Skill 列表

    • 根据项目类型和需求调整核心 Skills
    • 前端项目可增加组件开发、状态管理等 Skills
    • 后端项目可增加数据库操作、API 设计等 Skills
    • 全栈项目可包含前后端相关的 Skills
  3. 添加项目特定 Skills

    • 根据项目的特殊需求添加定制 Skills
    • 例如:电商项目可添加商品管理、订单处理等 Skills
    • 例如:AI 项目可添加模型训练、数据处理等 Skills
  4. 生成 Skills 工程

    • 将调整后的提示词发送给 Claude
    • 等待 Claude 生成完整的 Skills 工程
    • 检查生成的 Skills 是否符合需求
  5. 部署和使用

    • 将生成的 .trae/skills/ 目录复制到项目中
    • 团队成员学习和使用 Skills
    • 定期更新和维护 Skills

最佳实践

1. 定期更新 Skills

  • 每季度检查一次 Skills 是否需要更新
  • 根据项目需求变化添加或修改 Skills
  • 收集团队反馈,持续优化 Skills

2. 鼓励团队贡献

  • 允许团队成员修改和添加 Skills
  • 建立 Skills 审核和更新机制
  • 定期分享和交流 Skills 使用经验

3. 结合 CI/CD 使用

  • 在 CI/CD 流程中集成 Skills
  • 例如:代码提交前自动运行代码质量检查 Skill
  • 例如:部署前自动运行构建测试 Skill

4. 监控 Skills 使用情况

  • 记录 Skills 的使用频率和效果
  • 分析哪些 Skills 最常用、最有效
  • 优化和改进使用较少的 Skills

示例定制

前端项目示例

作为一名专业的 AI Agent 工程师,请为我的新项目创建一个完整的 Skills 工程。

### 项目信息
- **项目名称**:ReactAdmin
- **项目类型**:前端
- **技术栈**:React 18 + TypeScript + Vite + Ant Design + Redux Toolkit
- **核心功能**:企业级后台管理系统,包含用户管理、权限管理、数据统计等功能

### 要求

1. **创建完整的 Skills 目录结构**
   - 按照 Claude Skills 标准创建 `.trae/skills/` 目录
   - 包含 8 个核心 Skills

2. **核心 Skills 设计**
   - 项目初始化检查 Skill
   - React 组件开发 Skill
   - Redux 状态管理 Skill
   - Ant Design 使用 Skill
   - API 服务开发 Skill
   - 代码质量检查 Skill
   - 测试执行 Skill
   - 构建部署 Skill

3. **SKILL.md 格式规范**
   - 包含 YAML 元数据
   - 清晰的使用场景
   - 详细的操作步骤
   - React 代码示例
   - 最佳实践
   - 常见问题

4. **渐进式披露设计**
   - 遵循三层加载机制
   - 元数据简洁明了
   - 指令详细完整
   - 资源按需引用

5. **团队协作友好**
   - 包含使用指南
   - 清晰的命名规范
   - 标准化的结构
   - 易于扩展和维护

后端项目示例

作为一名专业的 AI Agent 工程师,请为我的新项目创建一个完整的 Skills 工程。

### 项目信息
- **项目名称**:FastAPIBackend
- **项目类型**:后端
- **技术栈**:Python 3.11 + FastAPI + SQLAlchemy 2.0 + PostgreSQL + Redis
- **核心功能**:RESTful API 服务,包含用户认证、数据管理、缓存等功能

### 要求

1. **创建完整的 Skills 目录结构**
   - 按照 Claude Skills 标准创建 `.trae/skills/` 目录
   - 包含 8 个核心 Skills

2. **核心 Skills 设计**
   - 项目初始化检查 Skill
   - FastAPI 开发 Skill
   - SQLAlchemy 数据库操作 Skill
   - Redis 缓存使用 Skill
   - 认证授权 Skill
   - 代码质量检查 Skill
   - 测试执行 Skill
   - 构建部署 Skill

3. **SKILL.md 格式规范**
   - 包含 YAML 元数据
   - 清晰的使用场景
   - 详细的操作步骤
   - Python 代码示例
   - 最佳实践
   - 常见问题

4. **渐进式披露设计**
   - 遵循三层加载机制
   - 元数据简洁明了
   - 指令详细完整
   - 资源按需引用

5. **团队协作友好**
   - 包含使用指南
   - 清晰的命名规范
   - 标准化的结构
   - 易于扩展和维护

预期效果

使用本提示词创建的 Skills 工程将带来以下好处:

  1. 提高开发效率:标准化的开发流程,减少重复工作
  2. 提高代码质量:统一的代码规范和质量检查
  3. 降低学习成本:新团队成员可以快速上手
  4. 增强团队协作:标准化的工作方式
  5. 充分利用 AI 能力:AI 辅助开发更加高效
  6. 易于扩展和维护:模块化的 Skill 设计

后续维护

  1. 定期更新:根据项目需求和技术栈变化更新 Skills
  2. 收集反馈:定期收集团队成员的使用反馈
  3. 优化改进:根据反馈和实际使用情况优化 Skills
  4. 文档更新:保持 Skills 文档的最新状态
  5. 培训分享:定期组织 Skills 使用培训和分享

创建日期:2026-01-20 版本:1.0.0 适用范围:通用型 Skills 工程创建