From 8cf6b4f9e6f9f5acf43ccbab484d12fb6428a2a2 Mon Sep 17 00:00:00 2001 From: AI Assistant Date: Tue, 31 Mar 2026 01:46:11 +0000 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0ai-assistant-creator=E6=8A=80?= =?UTF-8?q?=E8=83=BD=EF=BC=88=E4=BD=BF=E7=94=A8=E5=AE=98=E6=96=B9skill-cre?= =?UTF-8?q?ator=E6=8C=87=E5=AF=BC=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 按照官方skill-creator最佳实践创建 - 完整的9步标准化流程 - 详细的错误处理和恢复机制 - 清晰的触发条件和使用场景 - 包含沟通原则和最佳实践 - 提供参考资源和工具速查 这个技能替代了之前手动创建的skill-creator， 更符合官方规范且功能更完整 --- ai-assistant-creator/SKILL.md | 345 ++++++++++++++++++++++++++++++++++ 1 file changed, 345 insertions(+) create mode 100644 ai-assistant-creator/SKILL.md diff --git a/ai-assistant-creator/SKILL.md b/ai-assistant-creator/SKILL.md new file mode 100644 index 0000000..a1733e2 --- /dev/null +++ b/ai-assistant-creator/SKILL.md @@ -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`。 \ No newline at end of file