Ask Why 是一个面向 AI Agent 的 Skill，旨在通过多轮问答的方式增强Agent实现时的用户参与度，将设计者的意志的贯彻在Agent的执行过程中，来更好处理边界模糊的开放式规划任务，例如产品设计、研究计划、技术方案、PRD、工作流设计、Agent 设计和 Skill 设计。
Codex / Claude Code 在使用 Plan 模式处理产品设计、研究规划等复杂任务时，已经具备了一定的主动提问能力。
但这类提问很多时候内容不够明确，选项解释不够清楚，用户虽然知道自己进行了选择，却不一定知道：为什么要选？这个选择会影响什么？当前方案还有哪些风险？有没有更好的方向？同时，这类提问不一定能覆盖方案的所有细节，他们自作主张地进行一些决定，最终导致反复的方案调整。
Ask Why （十万个为什么）skills想解决的正是这个问题。 它更强调问题的质量，旨在通过更优质更全面的问题，精准识别用户意图，帮助用户进行完整的计划、思考与选择：当前方案是什么？有哪些潜在弱点？还有哪些值得探索的方向？现在最应该做哪些决策？
Ask Why 会把这些不确定性转化为一张张问题卡。用户得到的不只是一个最终方案，而是一条清晰、连续、可复盘的思考路径。最后实现一版方案满足用户需求。 小时候，《十万个为什么》通过一个个“为什么”教我们认识世界；现在，Ask Why 用同样的方式，帮助我们把复杂计划想清楚：为什么这样？有没有别的可能？哪里可能不成立？换一个条件，结果是否会不同？
小时候，《十万个为什么》通过一个个“为什么”教我们认识世界；现在，Ask Why 用同样的方式帮助我们把复杂计划想清楚：为什么这样？有没有别的可能？哪里可能不成立？换一个条件，结果是否会不同？
Ask Why 的目标不是替用户做决定，而是帮助用户把每一个重要决定想清楚。
适合使用 Ask Why 的情况：
- 任务还很模糊，但早期方向会明显影响结果。
- 有多个合理路线，需要用户做取舍。
- 需求、边界、受众、成功标准或风险偏好还没有说清。
- 你需要一份可追踪的计划，里面包含已确认决策、未解决问题和最终执行路径。
- 你希望留下
PLAN.md、DECISIONS.md、OPEN_QUESTIONS.md和FINAL_PLAN.md作为后续执行依据。
不适合使用 Ask Why 的情况：
- 简单事实问答。
- 常规代码修复或直接执行任务。
- 翻译、润色、一次性写作。
- 用户已经给出完整规格，只需要实现。
Ask Why 不是把模糊需求直接包装成一个看似完整的答案，而是先判断是否真的需要追问，再用一轮轮可回答、可记录、可收敛的问题，把不确定性变成清楚的决策。
进入 Ask Why 流程后，Skill 会：
- 通过 Entry Gate 判断任务是否值得进入追问模式。只有当任务模糊、用户偏好会影响结果、存在多个可行方向、错误选择会造成返工，并且用户愿意共同设计时，才会启动完整流程。
- 读取
references/formats.md，使用固定的状态文件、问题卡、阶段总结、草案和最终计划格式。 - 先理解任务，而不是直接给最终方案；同时建立模糊点地图，识别目标、受众、使用场景、交互粒度、平台环境、输出格式、成功标准、风险偏好和边界问题。
- 按重要程度把未知问题标记为
P0、P1或P2，区分哪些问题会阻塞后续设计，哪些会影响核心方案，哪些可以暂时延后确认。
- 每轮提出 3 到 5 个聚焦的决策问题。每个问题都会尽量给出上下文、示例、选项、推荐和影响，而不是把一个空问题丢给用户猜。
- 用户回答后，Skill 会同步更新
PLAN.md、DECISIONS.md和OPEN_QUESTIONS.md，把当前计划、已确认选择和未解决问题沉淀下来。
- 前三轮更偏发散：主动挑战假设，指出当前方案的潜在弱点，提供值得探索的替代方向。
- 每 2 到 3 轮进行一次阶段小结，帮助用户确认已经达成的共识、计划发生的变化，以及仍然悬而未决的问题。
- 从第四轮开始逐步收敛：减少不必要的扩展，优先解决真正影响执行的关键问题。当阻塞问题解决后生成计划草案；当剩余不确定性已经明确且不阻塞执行时，写出
FINAL_PLAN.md。
优先级含义：
P0: 阻塞设计，必须先回答。P1: 会改变核心计划，应尽快确认。P2: 可以暂时假设，后续再确认。
默认情况下，Ask Why 会在可写环境中维护：
p2a-session/
|-- PLAN.md
|-- DECISIONS.md
|-- OPEN_QUESTIONS.md
`-- FINAL_PLAN.md
PLAN.md: 当前版本、目标、非目标、核心机制、工作流、输出、风险和下一阶段。DECISIONS.md: 追加记录已确认选择、理由和计划影响。OPEN_QUESTIONS.md: 跟踪未解决的P0、P1、P2问题。FINAL_PLAN.md: 方向收敛后的最终计划。
如果当前环境不可写，Skill 会使用相同标题在对话中维护这些状态。
直接把下面这句话发给你的 AI 助手：
帮我安装 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 目录：
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 目录：
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 列表时就可以加载它。
触发名：
$Ask_Why
默认提示词的中文含义：
使用 $Ask_Why，把我模糊的产品、工作流、研究或技术想法转化为带决策记录的计划。
中文示例：
使用 $Ask_Why，帮我把这个模糊的产品想法整理成可执行计划：我想做一个面向研究人员的文档标注工作流，但还不确定用户、功能边界和评估指标。
另一个示例：
使用 $Ask_Why，把我模糊的研究工作流想法转化为带决策记录的计划。我知道大方向，但受众、范围和成功标准还不清楚。
.
|-- README.md
|-- LICENSE
|-- assets/
| `-- ask-why/
`-- Ask_Why/
|-- SKILL.md
|-- agents/
| `-- openai.yaml
`-- references/
`-- formats.md
Ask_Why/SKILL.md: Skill 入口和核心工作流。Ask_Why/references/formats.md: 状态文件、决策问题、阶段总结、草案和最终计划的固定格式。Ask_Why/agents/openai.yaml: 面向 Skill 列表和默认提示词的展示元数据。assets/ask-why/: README 使用的宣发配图。
GitHub: https://github.com/maxkura/Ask_Why.git
本项目使用 MIT 许可证，详见 LICENSE。