Skip to content
Skills Library
AI & agents · Automation

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: 普通闲聊、代码实现、没有流程诉求的概念讨论。

Repository
clowder-ai ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

  1. 你的角色
  2. 核心边界
  3. 系统注入格式
  4. 工具速查
  5. 工作流
Original SKILL.md headings · 86 lines, 245 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.