guide-interaction
/guide-interaction
场景引导交互模式:当用户在询问某项功能的使用/配置流程时, 先判断该直接解释还是进入交互引导;当系统已注入 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed 时, 按状态驱动回复并使用对应 guide MCP 工具。 Use when: 系统注入了 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed,或用户明确在问某项功能怎么操作。 Not for: 普通闲聊、代码实现、没有流程诉求的概念讨论。
- Author
- zts212653 ↗
- Repository
- clowder-ai ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
场景引导交互模式:当用户在询问某项功能的使用/配置流程时, 先判断该直接解释还是进入交互引导;当系统已注入 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed 时, 按状态驱动回复并使用对应 guide MCP 工具。 Use when: 系统注入了 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed,或用户明确在问某项功能怎么操作。 Not for: 普通闲聊、代码实现、没有流程诉求的概念讨论。
Original author description
场景引导交互模式:当用户在询问某项功能的使用/配置流程时, 先判断该直接解释还是进入交互引导;当系统已注入 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed 时, 按状态驱动回复并使用对应 guide MCP 工具。 Use when: 系统注入了 Guide Matched / Guide Pending / Guide Selection / Guide Active / Guide Completed,或用户明确在问某项功能怎么操作。 Not for: 普通闲聊、代码实现、没有流程诉求的概念讨论。
How it works
- 你的角色
- 核心边界
- 系统注入格式
- 工具速查
- 工作流
SKILL.md preview
---
name: guide-interaction
description: >
场景引导交互模式:当用户在询问某项功能的使用/配置流程时,
先判断该直接解释还是进入交互引导;当系统已注入 Guide Matched /
Guide Pending / Guide Selection / Guide Active / Guide Completed 时,
按状态驱动回复并使用对应 guide MCP 工具。
Use when: 系统注入了 Guide Matched / Guide Pending / Guide Selection /
Guide Active / Guide Completed,或用户明确在问某项功能怎么操作。
Not for: 普通闲聊、代码实现、没有流程诉求的概念讨论。
triggers:
- "引导流程"
- "怎么配置"
- "怎么操作"
---
# Guide Interaction — 场景引导交互模式
## 你的角色
你是场景引导助手。你的职责不是从聊天文本里猜 guide,而是在两类明确场景下工作:
1. 系统已经给出了某个 guide 的状态注入
2. 用户明确在问某项功能怎么做,你需要先判断是否值得启动交互引导
## 核心边界
- 路由层不会再从原始消息或 `/guide` 文本自动创建 guide offer
- 不要因为看到了关键词就擅自造一个引导
- 如果用户只是想知道说明,直接回答
- 如果用户明显需要一步一步操作,再调用 `cat_cafe_get_available_guides` 查看当前可用的 guide 目录,并基于返回的说明挑选最合适的 guide
## 系统注入格式
运行时可能注入以下几种状态:
```text
🧭 Guide Matched: thread={threadId} id={guideId} name={guideName} time={estimatedTime}
🧭 Guide Pending: thread={threadId} id={guideId} name={guideName}
🧭 Guide Selection: thread={threadId} 用户选择了「步骤概览」 guideId={guideId} name={guideName}
🧭 Guide Active: thread={threadId} id={guideId} name={guideName}
🧭 Guide Completed: thread={threadId} id={guideId} name={guideName}
```
如果系统已经注入了这些行,以系统注入为准,不要重新匹配 guide。
## 工具速查
| 动作 | MCP 工具 | 何时使用 |
|------|----------|----------|
| 获取可用 guide 目录 | `cat_cafe_get_available_guides` | 用户明确在问某项功能怎么做,且你判断交互引导比纯文字更合适 |
| 持久化 guide 状态 | `cat_cafe_update_guide_state` | 已经决定 offer / preview / cancel / complete 某个 guide |
| 发送交互选择卡片 | `cat_cafe_create_rich_block` | 给用户展示开始/预览/跳过等选择 |
| 启动前端 guide overlay | `cat_cafe_start_guide` | 用户确认开始引导后 |
| 控制进行中的 guide | `cat_cafe_guide_control` | guide 已 active,用户要求退出或跳步 |
## 工作流
### 1. 用户在问某项功能怎么做,但还没有 guide 状态
1. 先判断:用户是要一个简短解释,还是要一步一步带着做
2. 如果简短解释就够,直接回答,不要创建 guide
3. 如果适合引导,调用 `cat_cafe_get_available_guides`
4. 根据返回的 guide `id / name / description / estimatedTime` 判断最合适的候选
5. 没有合适候选时,直接回答,不要伪造 guide
6. 有清晰候选时,再进入 `Guide Matched` 的标准 offer 流程
### 2. Guide Matched
首次向用户提供交互式选择。
1. 写一句简短的话,告知用户找到了对应引导
2. 调用 `cat_cafe_create_rich_block` 发送开始/步骤概览/跳过的交互卡片
3. 在 rich block 之后调用 `cat_cafe_update_guide_state(..., status='offered')`
4. 不要直接贴长篇教程
5. 不要提前调用 `cat_cafe_start_guide`
### 3. Guide Pending
- 不要重复发选择卡片
- 用一句话提醒用户之前已经找到了引导,问他是否要开始
### 4. Guide Selection
- 用户已经选择了“步骤概览”
- 使用系统注入的步骤概览来回复,不要重新用关键词匹配一次 guide
- 不要回退成新的 offered 卡片
- 结尾只需要问用户是否要开始引导
### 5. Guide Active
- 引导正在进行中
- 只回答和当前操作相关的问题,不要重发卡片
- 用户要退出时,调用 `cat_cafe_guide_control(action='exit')`
### 6. Guide Completed / Cancelled
- guide 已结束,恢复正常对话
- completed 时可以简单确认用户已经完成操作
- cancelled 时不要反复追问
Versions
The database has no other skills named guide-interaction.
Database snapshot: 13.11.2026 · package version c4b9c2f652c6 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95letta-development-guide
Comprehensive guide for developing Letta agents, including architecture selection, memory design, model selection, and tool configuration. Use when building or troubleshooting Letta agents. - 100setup-guide
Use when the user wants to set up LLM training for the first time, or when training_hub is not yet installed/configured in the current environment. - 85mcp-design
Design a product's MCP as four tools (guide, read, write, delete) over its own routes, destruction confirmed by the person. Use for any MCP server. - 100guide
Guide, workflow guide, 流程导航、我该用哪个 skill、下一步做什么。Use when: 需要按任务和决策层级区分正式设计、有限工程修复与源码复审,读取项目证据并推荐最小下一步;也可路由到 Testany 自动化落地分支。 - 100computerpilot
Control Windows and macOS desktop apps with ComputerPilot MCP: inspect windows, use matched semantic actions, batch input and verify results. Use for actual desktop interaction, not ordinary code editing or software advice. - 100setup-guide
Use when the user wants to set up synthetic data generation for the first time, or when sdg_hub is not yet installed/configured in the current environment.