# 私有 Skill 创建流程

> 你是 AI Agent，此文档指导你如何帮助用户通过飞书总助理创建需求分析 Skill。

---

## 核心流程说明

私有 Skill 创建**不是由你在本地完成**，而是：
1. 用户在飞书与**总助理 Agent** 对话
2. 总助理创建任务
3. 任务分配到**技能创作部**执行
4. 技能创作部完成 Skill 创建
5. 用户验收确认

---

## Step 1：获取总助理 ID 和 Workspace 路径

**执行命令：**
```bash
opclawtm list-agents --role assistant
```

**向用户说明：**
- 记录总助理 ID（如：assistant_main）
- 总助理的 workspace 路径：`~/.openclaw/agents/{总助理ID}/workspace/skills/`

**示例：**
- 总助理 ID：`assistant_main`
- Skills 路径：`~/.openclaw/agents/assistant_main/workspace/skills/`

---

## Step 2：引导用户打开飞书

**向用户说明：**
- 打开飞书客户端
- 找到已绑定的总助理 Bot
- 开始与总助理对话

---

## Step 3：提供完整需求说明

**向用户发送以下完整内容，让用户复制到飞书：**

```
【Skill 创建需求】

任务类型：私有 Skill 创建

目标 Agent：assistant_main（总助理）
目标路径：~/.openclaw/agents/assistant_main/workspace/skills/requirement-analyst/

Skill 名称：requirement-analyst

触发场景：
1. 用户发送一个新的任务需求
2. 用户描述的问题比较模糊，需要进一步澄清
3. 用户说"我想要..."、"我需要一个..."等表达需求的语句

Skill 功能：
这是一个需求分析助手，帮助总助理更好地理解用户需求，引导用户完善需求描述。

核心能力：
1. 识别需求类型：功能需求、问题修复、优化改进、咨询问询
2. 提取关键信息：用户想要什么、为什么想要、期望的结果是什么
3. 识别缺失信息：需求描述中缺少的关键细节
4. 引导用户补充：通过提问帮助用户完善需求

工作流程：
1. 接收需求描述
2. 分析需求类型和复杂度
3. 提取关键信息点
4. 识别信息缺口
5. 生成引导性问题
6. 汇总完整需求

输出标准：
1. 需求类型判断
2. 关键信息清单（已明确的内容）
3. 信息缺口清单（需要补充的内容）
4. 引导性问题列表（帮助用户补充信息）
5. 结构化需求文档（用户确认后生成）

交互示例：
用户："我想要一个功能"
Skill 输出：
- 需求类型：功能需求
- 已明确：用户需要新功能
- 需补充：具体功能描述、使用场景、期望效果
- 引导问题：
  1. 请描述您需要的功能具体做什么？
  2. 这个功能在什么场景下使用？
  3. 您期望达到什么效果？

目标部门：技能创作部
```

**向用户说明：**
- 复制以上完整内容
- 在飞书中发送给总助理
- 总助理会自动创建任务并分配到技能创作部

---

## Step 4：等待任务完成

**向用户说明：**
- 任务创建后，技能创作部会开始执行
- 整个流程约需 10-30 分钟
- 完成后总助理会通知用户

---

## Step 5：验证成果物

### 5.1 验证任务过程文档

**引导用户打开任务目录：**

**Windows：**
```
C:\Users\{用户名}\.openclaw\task\{任务ID}\
```

**Mac/Linux：**
```
~/.openclaw/task/{任务ID}/
```

**向用户说明：**
- 任务目录包含任务执行过程的详细文档
- 可查看任务分解、执行记录、审核记录等

### 5.2 验证 Skill 成果物

**引导用户打开 Skills 目录：**

**Windows：**
```
C:\Users\{用户名}\.openclaw\agents\assistant_main\workspace\skills\requirement-analyst\
```

**Mac/Linux：**
```
~/.openclaw/agents/assistant_main/workspace/skills/requirement-analyst/
```

**向用户说明：**
- 查看是否存在 `requirement-analyst` 文件夹
- 文件夹内应有 `SKILL.md` 文件
- 可查看 Skill 内容是否符合预期

---

## Step 6：完成验收

**引导用户操作：**
1. 在飞书中与总助理对话
2. 确认任务完成，回复"验收通过"
3. 总助理会清理参与任务的 Agent 会话

**向用户说明：**
- 验收后总助理会删除参与任务的 Agent 会话
- **这是正常情况，不要担心**
- 会话清理是为了释放上下文空间

---

## 注意事项

1. **不要在本地创建 Skill 文件** → 通过飞书总助理创建
2. **总助理 ID 和路径必须正确** → 先查询确认
3. **需求说明要完整详细** → 包含触发场景、功能、工作流程、输出标准
4. **Skill 名称用英文** → 避免飞书解析问题
5. **目标路径要明确** → 让技能创作部知道存放位置
6. **验收后清理会话是正常的** → 不影响已创建的 Skill