---
name: grounded-workflows
description: "知识驱动的 AI 工作流系统入口。融合 DeepWiki 知识源、Tree of Thoughts 推理和结构化工作流，自动识别用户意图并路由到对应 skill。"
---

# Grounded Workflows

Grounded Workflows 是一套**知识驱动的 AI 工作流系统**：以 DeepWiki 等知识源对回答与方案进行**接地（grounding）**，结合 Superpower 风格的**结构化阶段与检查清单**，并辅以 **Tree of Thoughts** 式的**多路径探索与择优推理**。系统根据用户自然语言输入自动识别意图，将任务路由到最合适的下游 skill，在保证可追溯性的前提下完成从构思到落地、再到审查的闭环。

## 可用 Skill

| Skill | 触发关键词 | 描述 |
|-------|-----------|------|
| grounded-deepwiki | 「生成 wiki」、「生成文档」、「创建知识库」 | 扫描项目代码，生成结构化 `.deepwiki/` 知识库 |
| grounded-knowledge-prepare | 「准备知识」、首次使用 | 确保 `.deepwiki/` 知识库就绪，完成索引或同步等前置步骤 |
| grounded-brainstorming | 「设计」、「想想」、「brainstorm」 | 在知识接地的前提下进行头脑风暴与方案发散 |
| grounded-planning | 「计划」、「实施」、「怎么做」 | 基于仓库与文档上下文生成可执行的实施计划 |
| grounded-critique | 「审查」、「review」、「检查」 | 对已有方案、计划或实现进行批判性审查与风险识别 |

## 意图识别规则

按用户输入的**主要意图**路由；若同时命中多类，以**最后出现或语气最强**的意图为准，必要时向用户确认。

1. **知识库生成类** → 路由到 **grounded-deepwiki**（读取 `skills/grounded-deepwiki/SKILL.md`）  
   当用户需要为项目生成 wiki 文档、创建知识库、分析代码架构或进行深度代码研究时使用。

2. **设计 / 创意类** → 路由到 **grounded-brainstorming**（读取 `skills/grounded-brainstorming/SKILL.md`）  
   当用户主要在寻求想法、多种可选方案、产品/功能层面的构思或探索性讨论时使用。

3. **实施 / 计划类** → 路由到 **grounded-planning**（读取 `skills/grounded-planning/SKILL.md`）  
   当用户需要可执行步骤、任务拆解、里程碑、技术实施路径或「如何从现状走到目标」时使用。

4. **审查 / 检查类** → 路由到 **grounded-critique**（读取 `skills/grounded-critique/SKILL.md`）  
   当用户请求对文档、设计、计划或代码进行评审、找问题、评估合理性时使用。

5. **意图不明确** → **不要猜测性执行**；向用户提出**少量、具体**的澄清问题（例如：更偏向「先发散方案」还是「直接要实施步骤」？是否有必须遵守的约束？），再根据回答路由。

### 关键词列表（匹配时建议不区分大小写；中英文混合输入一并考虑）

- **grounded-deepwiki（知识库生成）**  
  `生成 wiki`、`生成文档`、`创建知识库`、`generate wiki`、`文档化`、`分析架构`、`深度研究`、`deep research`、`analyze`

- **brainstorming（设计 / 创意）**  
  `设计`、`想想`、`探索`、`方案`、`brainstorm`、`功能`、`创意`、`怎么设计`、`think about`

- **planning（实施 / 计划）**  
  `计划`、`实施`、`怎么做`、`怎么实现`、`拆解`、`步骤`、`implement`、`plan`、`how to build`

- **critique（审查 / 检查）**  
  `审查`、`review`、`检查`、`有问题吗`、`评审`、`critique`、`check`、`合理吗`

**grounded-knowledge-prepare** 不按上述四分法路由，而由「首次使用」或用户明确说「准备知识」触发（见下文「首次使用引导」）。

## 路由指令

1. 根据 **「意图识别规则」** 确定目标 skill。  
2. 匹配到 skill 后，**必须读取**该 skill 目录下的 `SKILL.md` 全文，并**严格遵循**其中的步骤、约束与输出格式。  
3. Skill 文件路径（相对于本仓库根目录）：  
   - `skills/grounded-deepwiki/SKILL.md`  
   - `skills/grounded-knowledge-prepare/SKILL.md`  
   - `skills/grounded-brainstorming/SKILL.md`  
   - `skills/grounded-planning/SKILL.md`  
   - `skills/grounded-critique/SKILL.md`  
4. 若目标 `SKILL.md` 不存在或无法读取，应如实告知用户，并建议先补齐 skill 或改用 `grounded-knowledge-prepare` 完成知识库准备，而不是编造 skill 内容。

## 首次使用引导

- 若判断用户**首次使用** grounded-workflows，应**优先建议**从 **grounded-knowledge-prepare** 开始，确保后续 brainstorming / planning / critique 都能访问已就绪的知识库。  
- **检查方式**：若当前工作区对应的项目根目录下**不存在** `.deepwiki/` 目录，则**视为首次使用**（或知识库尚未初始化），此时应主动说明并引导执行 `skills/grounded-knowledge-prepare/SKILL.md`。grounded-knowledge-prepare 会进一步引导用户使用内置的 `skills/grounded-deepwiki/SKILL.md` 生成知识库。  
- 若 `.deepwiki/` 已存在，可按用户当前意图直接路由到 brainstorming、planning 或 critique；用户仍可随时要求执行「准备知识」以更新或修复知识库，或直接使用 grounded-deepwiki skill 重新生成。

## 工作流衔接

- 典型完整链路为：**brainstorming → planning → critique**（先发散与定方向，再形成可执行计划，最后审查风险与缺口）。  
- 每个下游 skill 在完成其主要交付物后，应**根据当前产出**建议**合理的下一步**（例如：从 brainstorming 产出进入 planning；从 planning 进入实现或进入 critique；critique 之后可回到 planning 修订或进入实现）。  
- 衔接是**建议性**的：以用户明确指令为准；若用户只想执行其中一环，尊重其范围，不强行扩展任务。