# GUIDE.md — 对话引导逻辑

> 通过一步步对话，帮用户厘清"想要什么样的AI搭档"，最终生成可用的 SOUL.md + USER.md + AGENTS.md

---

## 整体对话架构

```
阶段1: 启动确认 (1-2轮)
阶段2: AI人格塑造 (4-6轮)
阶段3: 用户画像收集 (4-6轮)
阶段4: 工作规范定义 (3-5轮)
阶段5: 团队结构定义 (可选, 2-4轮)
阶段6: 生成与确认 (1-2轮)
阶段7: 验证与交付 (1-2轮)
```

**总轮次**：约 15-25 轮对话（快速模式约 5-8轮）

**原则**：每个问题都要有明确目的，不要问废话。

---

## ⚡ 快速模式流程

> 适用场景：老用户微调、紧急配置、时间有限

### 快速模式5问
1. **"你的AI叫什么？叫你什么？"** → SOUL名称、称呼
2. **"它最重要的3个特点是什么？"** → SOUL核心价值观
3. **"它绝对不能做什么？"** → SOUL红线
4. **"你主要用它做什么？"** → USER工作场景
5. **"你喜欢它怎么跟你说话？"** → SOUL说话风格

### 快速模式示例对话

```
小溪: 快速模式来了！5个问题，5分钟出结果。
      第一个：你的AI叫什么？你想怎么叫它？

用户: 叫小溪，叫我善人。

小溪: 好的，小溪和善人。第二个：它最重要的3个特点是什么？

用户: 直白、幽默、靠谱。

小溪: 第三个：它绝对不能做什么？

用户: 替我做重大决定，在我生气时说教。

小溪: 第四个：你主要用它做什么？

用户: 帮我分析投资、写文章、闲聊。

小溪: 最后一个：你喜欢它怎么跟你说话？

用户: 简洁直接，不要废话，少用"亲爱的"这种词。

小溪: 搞定！生成中...
```

---

## 阶段1：启动确认

### 目的
让用户知道要做什么，建立信任，收集基本信息（是否首次、用途）

### 对话示例

**小溪**：
> 嗨！我是你的AI搭档配置助手。  
>  
> 在我们开始之前，我想确认一下：你是**第一次配置**，还是想要**重新调整**现有的AI搭档？  
>  
> 另外，你主要是想为**自己**配置，还是想为**团队/公司**配置一个AI？

**用户回答**：
- 新手/首次 → 进入完整流程
- 重新配置 → 先问哪里不满意
- 个人使用 vs 团队 → 影响后续问题设计

---

## 阶段2：AI人格塑造（SOUL.md 素材）

> 目标是帮用户想清楚：这个AI搭档的"灵魂"是什么？

### 问题1：身份定位

> **问**："如果要用一句话描述你的AI搭档，你希望它是什么身份？比如：思维教练、写作助手、技术顾问、生活管家..."
>
> **目的**：确定AI的主要角色
>
> **追问**：
> - "这个身份的核心职责是什么？"
> - "它最擅长解决什么问题？"

### 问题2：名字与称呼

> **问**："你想怎么称呼你的AI搭档？它应该叫你什么？"
>
> **目的**：确定称呼方式，影响互动氛围
>
> **追问**（如用户没说）：
> - "你喜欢正式一点的称呼，还是随意一点的？"

### 问题3：核心价值观

> **问**："你的AI搭档应该最看重什么？从下面选3个，或自己说：  
> - 直白准确，不绕弯子  
> - 有温度，理解你的情绪  
> - 效率优先，快准狠  
> - 严谨靠谱，三思后行  
> - 敢于挑战你的想法（诤友）  
> - 幽默风趣，不死板  
> - 其他"
>
> **目的**：为SOUL.md的价值观部分收集素材
>
> **追问**：
> - "为什么这几个对你重要？"
> - "有什么是它绝对不能做的？"

### 问题4：行为风格

> **问**："当你的AI搭档给你建议时，你希望它是什么风格？"
>
> **选项**：
> - 谨慎型：先分析风险，再给建议
> - 激进型：直接给结论，你再判断
> - 教练型：引导你自己想明白
> - 诤友型：直接怼你，说你不爱听的
>
> **目的**：为SOUL.md的行为规则部分收集素材
>
> **追问**：
> - "举一个例子，当AI这样说会让你觉得'这就是我要的'？"

### 问题5：说话方式

> **问**："你希望你的AI搭档怎么跟你说话？"
>
> **选项**：
> - 简洁直接：少废话，结论先行
> - 详细解释：每一步都说明为什么
> - 轻松幽默：带点梗，不无聊
> - 严肃专业：正式，像顾问
>
> **目的**：为SOUL.md的说话风格部分收集素材
>
> **追问**：
> - "有没有你不喜欢的说话方式？比如：‘请问有什么可以帮您’这种？"

### 问题6：边界与红线

> **问**："有什么事情是你的AI搭档绝对不能做的？或者你应该不会让它碰的领域？"
>
> **目的**：为SOUL.md的红线部分收集素材
>
> **选项**：
> - 投资建议（如果你是稳健型）
> - 对外公开发布内容
> - 替你做重大决定
> - 访问你的私人账户
> - 其他
>
> **追问**：
> - "为什么这个边界对你重要？"

---

## 阶段3：用户画像收集（USER.md 素材）

> 目标是帮用户想清楚：你是谁，AI需要了解你什么？

### 问题1：基本信息

> **问**："简单介绍一下你自己：你的职业、你平时做什么、需要AI帮你解决什么问题？"
>
> **目的**：为USER.md的基础信息收集素材
>
> **追问**：
> - "你现在最头疼的问题是什么？"
> - "你希望AI帮你省时间还是省脑子？"

### 问题2：工作场景

> **问**："你主要在什么场景下使用AI？"
>
> **选项**：
> - 日常工作（写邮件、文档、报告）
> - 技术任务（代码、架构、调试）
> - 决策分析（投资、选择、策略）
> - 内容创作（文章、想法、创意）
> - 学习成长（读书、课程、技能）
> - 闲聊/咨询
>
> **目的**：确定USER.md的使用场景
>
> **追问**：
> - "哪个场景用得最多？"
> - "在这个场景里，你通常卡在哪里？"

### 问题3：沟通偏好

> **问**："你喜欢怎么跟AI互动？"
>
> **选项**：
> - 直接给指令，让AI执行
> - 先讨论思路，再让AI执行
> - 喜欢AI主动提问，不喜欢直接给答案
> - 希望AI多给几个选项，让我选
>
> **目的**：为USER.md的交互偏好收集素材
>
> **追问**：
> - "有没有什么沟通方式是你特别讨厌的？"

### 问题4：时区与时间

> **问**："你平时什么时候在线？AI需要在特定时间提醒你吗？"
>
> **目的**：为USER.md的时区、日程部分收集素材
>
> **追问**（如需要）：
> - "你希望AI在什么时间主动联系你？"
> - "有什么定期任务需要AI提醒你？"

### 问题5：敏感信息

> **问**："有什么是你不希望AI记住的，或者不希望它主动提起的？"
>
> **目的**：为USER.md的隐私边界收集素材
>
> **追问**：
> - "有没有什么话题你觉得不适合让AI参与讨论？"

---

## 阶段4：工作规范定义（AGENTS.md 素材）

> 目标是帮用户想清楚：AI应该按什么流程工作？

### 问题1：任务接收流程

> **问**："当你给AI一个任务时，你希望它怎么处理？"
>
> **选项**：
> - 直接执行：说完就做
> - 先确认理解：复述任务，你确认后再做
> - 先分析拆解：告诉你它打算怎么做，你同意再做
> - 先问优先级：多任务时，让AI判断先做哪个
>
> **目的**：为AGENTS.md的启动流程收集素材
>
> **追问**：
> - "如果任务很复杂呢？"
> - "如果任务需要你提供更多信息呢？"

### 问题2：验收标准

> **问**："你怎么判断AI做的工作是合格的？"
>
> **目的**：为AGENTS.md的验收流程收集素材
>
> **选项**：
> - 按时交付就行
> - 需要达到我的标准，我会检查
> - 要能说服我，给我选择
> - 其他
>
> **追问**：
> - "你有没有吃过AI做的东西不达标的亏？"
> - "什么样的输出会让你觉得'这就是我要的'？"

### 问题3：错误处理

> **问**："当AI犯错或不确定的时候，你希望它怎么做？"
>
> **选项**：
> - 直接说"我不知道"，让我自己解决
> - 先尝试，错了再告诉我
> - 先说"我不太确定，但我的判断是..."
> - 永远先问我
>
> **目的**：为AGENTS.md的错误处理流程收集素材
>
> **追问**：
> - "有什么错误是绝对不能犯的？"
> - "什么样的错误处理方式会让你失望？"

### 问题4：团队协作（如需要）

> **问**："你的AI需要和其他人协作吗？比如需要帮你写邮件给别人，或者在群里发言？"
>
> **目的**：为AGENTS.md的外部交互规则收集素材
>
> **追问**：
> - "它能以你的名义对外发言吗？"
> - "有什么限制？"

---

## 阶段5：团队结构定义（AGENTS.md 素材，可选）

> 如果用户说需要多个AI Agent

### 问题1：团队规模

> **问**："你需要一个AI还是多个AI组成团队？"
>
> **选项**：
> - 单一AI就够了
> - 2-3个专业AI
> - 复杂团队（CEO + 多个专家）
>
> **目的**：确定AGENTS.md的团队结构

### 问题2：角色分工

> **问**："如果多个AI，它们之间怎么分工？"
>
> **目的**：收集各Agent的职责定义
>
> **追问**：
> - "每个AI叫什么名字？"
> - "谁做决策，谁执行？"

---

## 阶段6：生成与确认

### 生成

根据对话内容，生成三个文件：

1. **SOUL.md** — AI的身份、价值观、行为规则、说话风格
2. **USER.md** — 用户的身份、工作场景、沟通偏好、隐私边界
3. **AGENTS.md** — 工作流程、验收标准、错误处理、团队结构

### 确认

> **小溪**：
> "我已经根据你的回答生成了三本说明书。让我展示给你看——"
>
> 展示文件内容，请用户确认

**可能的后续**：
- 有需要调整的地方 → 针对性修改
- 都满意 → 写入文件，给出使用建议
- 还想深挖 → 继续深入某个问题

---

## 阶段7：验证与交付

### 输出验证检查清单

生成后自动检查以下必填字段：

#### SOUL.md 必填字段检查
| 字段 | 要求 | 状态 |
|------|------|------|
| 身份定位 | 名称 + 一句话描述 | □ |
| 核心价值观 | 至少3个，带解释 | □ |
| 行为规则 | 至少2条可执行规则 | □ |
| 说话风格 | 喜欢的 + 禁止的 | □ |
| 红线 | 至少2条绝对不能做的事 | □ |

#### USER.md 必填字段检查
| 字段 | 要求 | 状态 |
|------|------|------|
| 基本信息 | 职业 + 背景 | □ |
| 工作场景 | 至少2个场景 | □ |
| 沟通偏好 | 喜欢的 + 不喜欢的 | □ |
| 时区 | UTC时区格式 | □ |
| 隐私边界 | 至少1条禁忌 | □ |

#### AGENTS.md 必填字段检查
| 字段 | 要求 | 状态 |
|------|------|------|
| 任务接收流程 | 明确处理方式 | □ |
| 验收标准 | 至少1条可判断标准 | □ |
| 错误处理 | 明确处理方式 | □ |

### 验证报告示例

```
✅ 验证通过

SOUL.md: 5/5 必填字段完整
USER.md: 5/5 必填字段完整
AGENTS.md: 3/3 必填字段完整

三本说明书均已就绪，可以直接使用。
```

### 交付+升级建议

> **小溪**：
> "三本说明书已验证通过！建议下一步：
> 
> 1. **安装 `workspace-bootstrap`** — 补充 SOUL.md、USER.md、AGENTS.md 以外的其他初始化文件
> 2. **安装 `scenario-sop`** — 建立常见场景的SOP，让你和AI的协作更高效
> 3. **安装 `memory-tiering`** — 建立记忆管理体系，让AI越用越懂你
> 4. **体验7天** — 用一段时间后告诉我哪里需要调整
> 
> 要我现在帮你写入文件吗？"

---

## 完整对话示例（20轮）

> 以下是完整模式的完整对话示例，包含用户回答

```
第1轮 - 启动
小溪: 嗨！我是你的AI搭档配置助手。我们今天帮你配置一个专属的AI搭档，
     生成 SOUL.md + USER.md + AGENTS.md 三本说明书。
     
     你是第一次配置，还是想重新调整现有的AI搭档？
用户: 第一次，第一次用openclaw。

第2轮 - 用途确认
小溪: 好的！那你主要是想为自己配置，还是想给团队或公司配置？
用户: 为自己，我是软件测试工程师，想让AI帮我分析投资、写文章。

第3轮 - AI身份定位
小溪: 明白了。如果用一句话形容你的AI搭档，你希望它是什么身份？
     比如：思维教练、写作助手、投资顾问、技术专家...
用户: 思维教练加投资顾问吧，帮我开拓第二曲线。

第4轮 - 名字与称呼
小溪: 那你想怎么称呼它？它应该叫你什么？
用户: 叫它小溪，叫我善人。

第5轮 - 核心价值观（第一优先级）
小溪: 小溪和善人，挺好。你的AI最看重的3个价值观是什么？
     比如：直白准确、效率优先、严谨靠谱、敢于挑战你...
用户: 直白准确，敢于挑战我的想法，还有...严谨靠谱吧。

第6轮 - 核心价值观（追问）
小溪: 为什么"敢于挑战你的想法"对你很重要？
用户: 因为我有时候会犯迷糊，需要有人拽着我。

第7轮 - 行为风格
小溪: 当小溪给你建议时，你希望它是什么风格？
     A. 直接给结论，你来判断
     B. 先分析风险，再给建议
     C. 引导你自己想明白
     D. 直接怼你，说你不爱听的
用户: D吧，直接怼我那种，但要有道理。

第8轮 - 说话方式
小溪: 你希望小溪怎么跟你说话？简洁直接，还是详细解释？
用户: 简洁直接，少废话，结论先行。

第9轮 - 说话方式（追问）
小溪: 有没有什么说话方式是你特别讨厌的？
用户: 最讨厌"请问有什么可以帮到您"这种废话，还有长篇大论。

第10轮 - 红线
小溪: 有什么事情是小溪绝对不能做的？
用户: 替我做重大决定，替我对外发言，在我生气的时候说教。

第11轮 - 用户基本信息
小溪: 了解。介绍一下你自己：职业、背景、主要用AI做什么？
用户: 38岁软件测试工程师，team leader，16年经验。想开拓第二曲线。

第12轮 - 工作场景（第一优先）
小溪: 你主要在什么场景下用AI？
用户: 投资分析、写公众号文章、偶尔写代码。

第13轮 - 工作场景（追问）
小溪: 哪个用得最多？通常卡在哪里？
用户: 投资分析用得最多，经常不知道该买还是该卖。

第14轮 - 沟通偏好
小溪: 你喜欢怎么跟AI互动？直接给指令，还是先讨论？
用户: 先讨论思路，我觉得对的再让它执行。

第15轮 - 任务接收流程
小溪: 当你给小溪一个任务时，你希望它怎么处理？
用户: 先分析拆解，告诉我打算怎么做，我同意再做。

第16轮 - 验收标准
小溪: 你怎么判断小溪做的工作是合格的？
用户: 能说服我，给我选择，让我最终决定。

第17轮 - 错误处理
小溪: 当小溪犯错或不确定时，你希望它怎么做？
用户: 先说"我不太确定，但我的判断是..."，然后给我选项。

第18轮 - 边界追问
小溪: 小溪能以你的名义对外发言吗？比如帮你写邮件？
用户: 投资相关的不行，生活类的可以。

第19轮 - 生成确认
小溪: 我已经根据你的回答生成了三本说明书。给你展示一下——
     [展示 SOUL.md, USER.md, AGENTS.md 内容]
     
     看看有没有需要调整的地方？
用户: 很好，基本不用改。

第20轮 - 验证与交付
小溪: ✅ 验证通过。三本说明书均已就绪。
     
     建议下一步：
     1. 安装 workspace-bootstrap 补充其他初始化文件
     2. 安装 scenario-sop 建立常见场景SOP
     3. 安装 memory-tiering 建立记忆体系
     4. 体验7天后告诉我效果
     
     要我现在帮你写入文件吗？
用户: 好的，写入吧。
```

---

## 问题设计原则

### 必须避免

1. **不要问开放式无焦点的问题**
   - ❌ "你有什么需求？"
   - ✅ "你想要AI帮你解决什么问题？"

2. **不要暗示正确答案**
   - ❌ "你是不是希望AI很聪明？"
   - ✅ "你觉得AI最应该擅长什么？"

3. **不要一次问多个问题**
   - ❌ "你喜欢什么样的沟通风格？工作时还是闲聊时？"
   - ✅ "你平时喜欢怎么跟AI聊天？"

4. **不要用模板化表达**
   - ❌ "根据您的描述，我为您生成..."
   - ✅ 用自己的话总结用户的回答，再说下一个问题

### 应该做的

1. **每个问题都要有明确目的**
2. **根据用户回答动态调整问题**
3. **追问要具体，跟用户的回答相关**
4. **适时总结，确认理解正确**
5. **语气自然，像在聊天而不是面试**

---

## 特殊情况处理

### 用户说"我不懂，你帮我想"

> 不要直接给建议，而是通过例子引导：
> - "那我给你几个选项，你看看哪个最接近你想要的感觉？"
> - "我见过有人这样描述他们的AI搭档...你觉得呢？"

### 用户回答很模糊

> 不要急着跳到下一个问题：
> - "能举个例子吗？比如你希望AI在什么情况下这样做？"
> - "有没有哪个AI（产品）让你觉得'这就是我要的感觉'？"

### 用户很着急，想要快速搞定

> 简化流程，只问最关键的3-5个问题：
> - 身份定位
> - 核心价值观
> - 验收标准
> - 说话风格
> 生成后就交付

### 用户说"我都行/随便"

> 给出推荐值，但说明原因：
> - "那我默认给你设置成直白准确的风格？如果你不喜欢可以调整。"
> - "这种场景一般人选择XX，我按这个来，可以吗？"

---

## 文件生成指南

### SOUL.md 必含内容

```markdown
# SOUL.md - 我是谁

## 身份
- 名称
- 定位（一句话）

## 愿景
- 核心目标

## 价值观
- 3-5个核心价值观（带解释）

## 行为规则
- 决策流程
- 红线（绝对不做的事）

## 说话风格
- 语言特点
- 禁止使用的表达

## 边界
- 能做的
- 不能做的
```

### USER.md 必含内容

```markdown
# USER.md - 用户信息

## 基本信息
- 职业
- 背景

## 工作场景
- 主要使用场景
- 痛点

## 沟通偏好
- 喜欢的交互方式
- 不喜欢的交互方式

## 时区与时间
- 时区
- 在线时间

## 隐私边界
- 敏感信息
- 禁忌话题
```

### AGENTS.md 必含内容

```markdown
# AGENTS.md - 工作规范

## 启动流程
- 接收任务后的处理方式

## 验收标准
- 怎么算合格

## 错误处理
- 犯错后怎么做

## 团队结构（可选）
- 各Agent的职责

## 外部交互规则（可选）
- 对外发言的限制
```

---

## 📋 快速参考卡

| 阶段 | 核心问题数 | 输出 |
|------|-----------|------|
| AI人格 | 6问 | SOUL.md |
| 用户画像 | 5问 | USER.md |
| 工作规范 | 4问 | AGENTS.md |
| 团队结构 | 2问 | AGENTS.md团队部分 |

**总问题数**：15-25问（快速模式5问）

---

_此文件是对话引导的核心逻辑库，按需查阅_