Ask_Why

KO | EN

gitlite — search

#hacktoberfest #llm #go #android #linux #macos #windows #awesome #kubernetes #vue #security #ios #mcp #open-source

(★ 119)

A codex planning mode enhancing skill，works better than codex planning mode.

Ask_Why Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ask Why（十万个为什么）

**简体中文** | [English](README_EN.md)

![Ask Why 与传统 Plan 模式对比](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/comparison.jpeg)

Codex / Claude Code 在使用 Plan 模式处理产品设计、研究规划等复杂任务时，会自作主张地进行一些决定，最终导致「反复的方案调整」。

Ask Why「十万个为什么」Skill 想解决的正是这个问题。

它更强调「问题的质量」，旨在通过更优质、更全面的问题，精准识别用户意图，帮助用户进行完整的计划、思考与选择。

小时候，《十万个为什么》通过一个个问题教我们认识世界；现在，Ask Why Skill 用同样的方式，帮助我们把复杂计划想清楚。

**Ask Why 的目标不是替用户做决定，而是帮助用户把每一个重要决定想清楚。**

## 仓库结构

- `Ask_Why/SKILL.md`：Skill 入口和核心工作流。
- `Ask_Why/references/formats.md`：状态文件、决策问题、阶段总结、草案和最终计划的固定格式。
- `Ask_Why/agents/openai.yaml`：面向 Skill 列表和默认提示词的展示元数据。
- `assets/ask-why/`：README 使用的示例和对比图。

## 核心工作流

调用 Ask Why 后，我们首先会将不同问题按重要程度划分优先级，每轮提出 3 到 5 个聚焦的决策问题。

- `P0`：阻塞设计，必须先回答。
- `P1`：会改变核心计划，应尽快确认。
- `P2`：可以暂时假设，后续再确认。

![Ask Why 决策问题卡](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/decision-card.png)

用户回答后，Skill 会同步更新 `PLAN.md`、`DECISIONS.md` 和 `OPEN_QUESTIONS.md`，把当前计划、已确认选择和未解决问题沉淀下来。

![Ask Why 状态同步](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/state-update.png)

前三轮会主动挑战假设、指出潜在弱点并探索替代方向；从第四轮开始逐步收敛。当阻塞问题解决、剩余不确定性不再影响执行时，Skill 会生成 `FINAL_PLAN.md`。

## 效果对比

### 对比 Brainstorming

不同于 Brainstorming，Ask Why 每一轮提问通常包含 3–5 个问题，因为复杂计划中的很多问题是互相影响的。

![Ask Why 与 Brainstorming 的提问方式对比](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/brainstorming.jpeg)

![Brainstorming 实际案例](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/brainstorming.png)

用户看到整组问题后，可以先整体权衡，再决定怎么选；也可以在看到新问题时，回头调整前面的答案。

### 对比 GStack

GStack 没有主动核实用户的到达与离开时间，也没有了解用户偏好的旅行强度，生成的计划因此无法很好地满足个性化需求。

![Ask Why 与 GStack 的效果对比](https://raw.githubusercontent.com/maxkura/Ask_Why/main/assets/ask-why/GStack.png)

## 适用场景

适合使用 Ask Why 的情况：

- 任务还很模糊，但早期方向会明显影响结果。
- 有多个合理路线，需要用户做取舍。
- 需求、边界、受众、成功标准或风险偏好还没有说清。
- 你需要一份包含已确认决策、未解决问题和最终执行路径的可追踪计划。

不适合使用 Ask Why 的情况：

- 简单事实问答。
- 常规代码修复或直接执行任务。
- 翻译、润色、一次性写作。
- 用户已经给出完整规格，只需要实现。

## 安装

### 最简单的方式

直接把下面这句话发给你的 AI 助手：

```text
帮我安装 Ask Why Skill，仓库地址：https://github.com/maxkura/Ask_Why.git。请安装仓库中的 Ask_Why/ 子目录到当前 IDE/Agent 的 Skill 目录。
```

> 本仓库根目录是发布主页，真正的 Skill 包在 `Ask_Why/` 子目录下。安装时请确保最终 Skill 目录里直接包含 `SKILL.md`。

### 手动安装

不同 IDE 或 Agent 常见的 Skill 目录：

| IDE 或 Agent | Skill 目录 |
| --- | --- |
| Qoder | `.qoder/skills/Ask_Why/` |
| Cursor | `.cursor/skills/Ask_Why/` |
| Trae | `.trae/skills/Ask_Why/` |
| Windsurf | `.windsurf/skills/Ask_Why/` |
| Claude Code | `.claude/skills/Ask_Why/` |
| Codex | `~/.codex/skills/Ask_Why/` |
| 通用 | `.agents/skills/Ask_Why/` |

安装到当前项目的通用 Skill 目录：

```bash
git clone https://github.com/maxkura/Ask_Why.git /tmp/Ask_Why-skill
mkdir -p .agents/skills
cp -R /tmp/Ask_Why-skill/Ask_Why .agents/skills/Ask_Why
```

安装到 Codex 全局 Skill 目录：

```bash
git clone https://github.com/maxkura/Ask_Why.git /tmp/Ask_Why-skill
mkdir -p ~/.codex/skills
cp -R /tmp/Ask_Why-skill/Ask_Why ~/.codex/skills/Ask_Why
```

只要目标目录下直接有 `SKILL.md`，Agent 下次启动或刷新 Skill 列表时就可以加载它。

## 使用

触发名：

```text
$Ask_Why
```

示例：

```text
使用 $Ask_Why，帮我把这个模糊的产品想法整理成可执行计划：我想做一个面向研究人员的文档标注工作流，但还不确定用户、功能边界和评估指标。
```

```text
使用 $Ask_Why，把我模糊的研究工作流想法转化为带决策记录的计划。我知道大方向，但受众、范围和成功标准还不清楚。
```

Ask_Why

Ask_Why Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Ask_Why

Ask_Why Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README