添加ai-assistant-creator技能（使用官方skill-creator指导）
- 按照官方skill-creator最佳实践创建 - 完整的9步标准化流程 - 详细的错误处理和恢复机制 - 清晰的触发条件和使用场景 - 包含沟通原则和最佳实践 - 提供参考资源和工具速查 这个技能替代了之前手动创建的skill-creator， 更符合官方规范且功能更完整
This commit is contained in:
AI Assistant
345
ai-assistant-creator/SKILL.md
Normal file
345
ai-assistant-creator/SKILL.md
Normal file
@@ -0,0 +1,345 @@
|
||||
---
|
||||
name: ai-assistant-creator
|
||||
description: 标准化AI助手和开发环境创建流程 - 自动化创建NanoClaw AI助手、AI对话、D8D工作空间和模板的完整流程。当用户请求创建新的AI助手、开发环境、项目设置、工作空间配置、或任何涉及AI助手+开发环境的项目时使用此技能。即使用户没有明确说"创建AI助手"，只要涉及到设置新的开发项目、配置AI助手、或建立开发环境，都应该触发此技能。
|
||||
---
|
||||
|
||||
# AI助手创建技能
|
||||
|
||||
这是一个完整的AI助手和开发环境创建流程，基于实战经验优化，包含9个标准化步骤和完整的错误处理机制。
|
||||
|
||||
## When to use
|
||||
|
||||
当用户请求以下任务时，使用此技能：
|
||||
- 创建新的AI助手（任何类型）
|
||||
- 创建AI对话或会话
|
||||
- 设置D8D工作空间和模板
|
||||
- 启动开发容器
|
||||
- 配置AI助手在容器中进行开发
|
||||
- 建立新的开发项目环境
|
||||
- 自动化项目初始化流程
|
||||
|
||||
**重要**: 即使用户没有明确提及"AI助手"，只要涉及到设置新的开发环境或配置项目，都应该考虑使用此技能。
|
||||
|
||||
## 技能概述
|
||||
|
||||
这个技能自动化了创建AI助手和相应开发环境的完整流程，包括：
|
||||
1. 需求确认和项目规划
|
||||
2. AI助手创建（NanoClaw）
|
||||
3. AI对话建立
|
||||
4. D8D工作空间配置
|
||||
5. 项目模板创建
|
||||
6. 开发容器启动
|
||||
7. AI助手配置和部署
|
||||
|
||||
## 创建流程
|
||||
|
||||
### 第一步：需求确认
|
||||
|
||||
询问用户以下关键信息：
|
||||
|
||||
**必需信息：**
|
||||
- 项目类型（如：Next.js管理后台、React应用、Python服务等）
|
||||
- 主要功能描述（简短说明项目目的）
|
||||
|
||||
**可选信息：**
|
||||
- 技术栈偏好（如：React、Vue、Python、Go等）
|
||||
- 特殊需求（如：需要数据库、缓存、特定服务等）
|
||||
- UI框架偏好（如：Ant Design、Material-UI）
|
||||
|
||||
### 第二步：创建AI助手
|
||||
|
||||
使用 `nanoclaw_create_ai_friend` 工具：
|
||||
|
||||
**参数模板：**
|
||||
```json
|
||||
{
|
||||
"name": "{项目类型} 开发助手",
|
||||
"trigger": "{简短英文触发词}",
|
||||
"description": "专门帮助开发{项目描述}的AI助手，熟悉{技术栈}等技术栈",
|
||||
"folder": "{文件夹名称}"
|
||||
}
|
||||
```
|
||||
|
||||
**命名规范：**
|
||||
- 助手名称: `{项目类型} 开发助手`
|
||||
- 触发词: 使用小写英文和连字符，如 `nextjs-admin`, `python-api`
|
||||
- 文件夹: 与触发词相同或使用项目名称
|
||||
|
||||
**示例：**
|
||||
```json
|
||||
{
|
||||
"name": "Next.js 管理后台开发助手",
|
||||
"trigger": "nextjs-admin",
|
||||
"description": "专门帮助开发Next.js管理后台的AI助手，熟悉React、Next.js、TypeScript、Tailwind CSS等技术栈",
|
||||
"folder": "nextjs-admin-helper"
|
||||
}
|
||||
```
|
||||
|
||||
### 第三步：创建AI对话
|
||||
|
||||
使用 `nanoclaw_create_conversation` 工具：
|
||||
|
||||
**参数模板：**
|
||||
```json
|
||||
{
|
||||
"title": "{项目名称}开发讨论",
|
||||
"type": "ai-friend"
|
||||
}
|
||||
```
|
||||
|
||||
**示例：**
|
||||
```json
|
||||
{
|
||||
"title": "Next.js 管理后台开发讨论",
|
||||
"type": "ai-friend"
|
||||
}
|
||||
```
|
||||
|
||||
### 第四步：关联助手和对话
|
||||
|
||||
使用 `nanoclaw_add_ai_friend_to_conversation` 工具：
|
||||
|
||||
**参数：**
|
||||
- `conversationId`: 从第三步返回的对话ID
|
||||
- `aiAgentId`: 从第二步返回的助手JID
|
||||
|
||||
### 第五步：创建D8D工作空间
|
||||
|
||||
使用 `d8d_create_workspace` 工具：
|
||||
|
||||
**参数模板：**
|
||||
```json
|
||||
{
|
||||
"name": "{项目名称}",
|
||||
"description": "{项目描述}"
|
||||
}
|
||||
```
|
||||
|
||||
**错误处理：**
|
||||
|
||||
如果创建失败（返回"未知错误"），执行以下备用方案：
|
||||
|
||||
1. **检查配额**: 使用 `d8d_get_my_quota` 确认配额充足
|
||||
2. **检查订阅**: 使用 `d8d_get_my_subscription` 确认订阅状态
|
||||
3. **使用现有工作空间**:
|
||||
- 使用 `d8d_list_workspaces` 列出可用工作空间
|
||||
- 优先选择测试/开发用的工作空间
|
||||
- 询问用户是否同意使用选定的工作空间
|
||||
4. **清理资源**: 如果已创建了临时资源，使用 `d8d_delete_template` 清理
|
||||
|
||||
### 第六步：创建项目模板
|
||||
|
||||
使用 `d8d_create_template` 工具：
|
||||
|
||||
**参数模板：**
|
||||
```json
|
||||
{
|
||||
"workspace_id": {工作空间ID},
|
||||
"name": "{项目名称}模板",
|
||||
"description": "完整的{项目描述}模板，包含{技术栈}等功能",
|
||||
"containerGroupId": {容器组配置ID},
|
||||
"isFeatured": false
|
||||
}
|
||||
```
|
||||
|
||||
**容器组配置ID参考：**
|
||||
- 11: 通用开发环境（推荐用于Web项目）
|
||||
- 其他配置ID根据项目需求选择
|
||||
|
||||
### 第七步：启动开发容器
|
||||
|
||||
使用 `d8d_start_dev_container` 工具：
|
||||
|
||||
**参数：**
|
||||
```json
|
||||
{
|
||||
"item_id": {模板ID},
|
||||
"item_type": "template"
|
||||
}
|
||||
```
|
||||
|
||||
**容器启动后信息：**
|
||||
- 保存返回的访问地址
|
||||
- 记录容器名称和端口
|
||||
- 确认容器状态为"运行中"
|
||||
|
||||
**错误处理：**
|
||||
如果启动失败，检查：
|
||||
1. 模板是否正确创建
|
||||
2. 容器组配置是否有效
|
||||
3. 用户配额是否充足
|
||||
4. 使用 `d8d_get_dev_container_status` 查看详细状态
|
||||
|
||||
### 第八步：配置AI助手
|
||||
|
||||
向AI助手发送配置消息，使用 `nanoclaw_send_message_wait_reply` 工具：
|
||||
|
||||
**配置消息模板：**
|
||||
```
|
||||
你好！你现在被指派为{项目名称}开发助手。
|
||||
|
||||
## 🎯 你的职责
|
||||
1. 在工作空间ID {workspace_id} 的模板ID {template_id} 中进行开发
|
||||
2. 使用开发容器工具进行开发工作
|
||||
3. 帮助用户构建{具体功能描述}
|
||||
|
||||
## 🔧 你可以使用的主要工具
|
||||
1. d8d_invoke_dev_container_subagent - 调用开发容器中的Claude子代理
|
||||
2. d8d_exec_dev_container_command - 在开发容器中执行命令
|
||||
3. d8d_get_dev_container_status - 查看容器状态
|
||||
|
||||
## 📦 开发环境信息
|
||||
- 工作空间: {workspace_name} (ID: {workspace_id})
|
||||
- 模板: {template_name} (ID: {template_id})
|
||||
- 容器状态: 已启动
|
||||
- 开发环境访问: {access_urls}
|
||||
|
||||
请确认你理解了你的职责，并准备开始开发工作！
|
||||
```
|
||||
|
||||
### 第九步：完成检查
|
||||
|
||||
确认以下项目已完成：
|
||||
|
||||
**核心项目：**
|
||||
- [ ] AI助手已创建
|
||||
- [ ] AI对话已创建
|
||||
- [ ] AI助手已添加到对话
|
||||
- [ ] 工作空间已创建（或选择现有的）
|
||||
- [ ] 模板已创建
|
||||
- [ ] 开发容器已启动
|
||||
- [ ] AI助手已接收配置信息
|
||||
- [ ] AI助手确认可以开始工作
|
||||
|
||||
**可选项目：**
|
||||
- [ ] 向用户提供了完整的访问地址
|
||||
- [ ] 记录了所有重要的ID和配置信息
|
||||
- [ ] 创建了项目文档或README
|
||||
|
||||
## 错误处理和恢复
|
||||
|
||||
### 常见错误场景
|
||||
|
||||
**1. 工作空间创建失败**
|
||||
- **原因**: API不可用、配额限制、权限问题
|
||||
- **解决方案**:
|
||||
1. 使用现有工作空间
|
||||
2. 清理临时创建的资源
|
||||
3. 提供多个解决方案供用户选择
|
||||
|
||||
**2. 容器启动失败**
|
||||
- **原因**: 模板配置错误、容器组配置无效、配额不足
|
||||
- **解决方案**:
|
||||
1. 检查模板配置
|
||||
2. 验证容器组配置
|
||||
3. 查看详细错误信息
|
||||
4. 重新创建模板
|
||||
|
||||
**3. AI助手响应慢或无响应**
|
||||
- **原因**: 容器未完全启动、网络问题、超时设置过短
|
||||
- **解决方案**:
|
||||
1. 检查容器状态
|
||||
2. 增加超时时间（建议120000ms）
|
||||
3. 分步骤执行
|
||||
|
||||
**4. 资源清理失败**
|
||||
- **原因**: 临时资源创建失败、权限问题
|
||||
- **解决方案**:
|
||||
1. 手动检查并删除
|
||||
2. 记录失败信息以便后续处理
|
||||
3. 继续执行后续步骤
|
||||
|
||||
## 沟通原则
|
||||
|
||||
**重要原则：**
|
||||
- **逐步确认**: 每个阶段都向用户确认进展
|
||||
- **透明沟通**: 及时汇报错误和问题
|
||||
- **提供选择**: 遇到问题时提供多个解决方案
|
||||
- **详细记录**: 保持详细的操作日志
|
||||
|
||||
**用户沟通模板：**
|
||||
```
|
||||
## 📊 当前进展
|
||||
✅ 已完成: {已完成项目}
|
||||
🔄 进行中: {当前步骤}
|
||||
⏳ 待处理: {下一步计划}
|
||||
|
||||
## ⚠️ 遇到的问题
|
||||
{问题描述}
|
||||
|
||||
## 💡 建议的解决方案
|
||||
1. 方案A: {描述}
|
||||
2. 方案B: {描述}
|
||||
3. 方案C: {描述}
|
||||
|
||||
您希望选择哪个方案？
|
||||
```
|
||||
|
||||
## 参考资源
|
||||
|
||||
**相关文档：**
|
||||
- `STANDARD_WORKFLOW.md` - 详细的问答式流程（13个关键问题）
|
||||
- `WORKFLOW_EXAMPLE.md` - 实战案例和经验总结
|
||||
- `CLAUDE.md` - AI助手使用指南
|
||||
|
||||
**常用工具速查：**
|
||||
```bash
|
||||
# AI助手相关
|
||||
nanoclaw_create_ai_friend # 创建AI助手
|
||||
nanoclaw_create_conversation # 创建对话
|
||||
nanoclaw_add_ai_friend_to_conversation # 关联助手和对话
|
||||
nanoclaw_send_message_wait_reply # 发送消息并等待回复
|
||||
|
||||
# D8D环境相关
|
||||
d8d_create_workspace # 创建工作空间
|
||||
d8d_create_template # 创建模板
|
||||
d8d_start_dev_container # 启动开发容器
|
||||
d8d_invoke_dev_container_subagent # 调用容器子代理
|
||||
d8d_exec_dev_container_command # 执行容器命令
|
||||
d8d_get_dev_container_status # 查看容器状态
|
||||
d8d_list_workspaces # 列出工作空间
|
||||
d8d_get_my_quota # 查看配额使用
|
||||
d8d_get_my_subscription # 查看订阅状态
|
||||
d8d_delete_template # 删除模板（清理用）
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
**1. 预检查**
|
||||
在开始流程前，检查：
|
||||
- 用户订阅和配额状态
|
||||
- API可用性
|
||||
- 现有资源情况
|
||||
|
||||
**2. 资源管理**
|
||||
- 及时清理临时创建的资源
|
||||
- 记录所有创建的资源ID
|
||||
- 提供资源清理建议
|
||||
|
||||
**3. 错误预防**
|
||||
- 使用合理的默认值
|
||||
- 提供参数验证
|
||||
- 设置合适的超时时间
|
||||
|
||||
**4. 用户体验**
|
||||
- 保持清晰的进度汇报
|
||||
- 提供详细的错误信息
|
||||
- 给出具体的解决建议
|
||||
|
||||
## 成功标准
|
||||
|
||||
一个成功的AI助手创建流程应该：
|
||||
1. **完整性**: 所有9个步骤都已完成
|
||||
2. **可用性**: AI助手能够响应并开始工作
|
||||
3. **稳定性**: 容器正常运行，可以开始开发
|
||||
4. **文档化**: 用户清楚了解如何使用新创建的环境
|
||||
5. **可恢复**: 提供了完整的错误处理和恢复机制
|
||||
|
||||
## 技能版本和更新
|
||||
|
||||
**当前版本**: 1.0
|
||||
**创建日期**: 2026-03-31
|
||||
**基于**: 实战经验和标准化流程
|
||||
**维护**: 基于用户反馈持续改进
|
||||
|
||||
如有问题或改进建议，请参考 `STANDARD_WORKFLOW.md` 或查看实战案例 `WORKFLOW_EXAMPLE.md`。
|
||||
Reference in New Issue
Block a user