Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ask Why(十万个为什么)

简体中文 | English

Ask Why 与传统 Plan 模式对比

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

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

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

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

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

仓库结构

.
|-- README.md
|-- README_EN.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 使用的示例和对比图。

核心工作流

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

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

Ask Why 决策问题卡

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

Ask Why 状态同步

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

效果对比

对比 Brainstorming

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

Ask Why 与 Brainstorming 的提问方式对比

Brainstorming 实际案例

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

对比 GStack

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

Ask Why 与 GStack 的效果对比

适用场景

适合使用 Ask Why 的情况:

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

不适合使用 Ask Why 的情况:

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

安装

最简单的方式

直接把下面这句话发给你的 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,把我模糊的研究工作流想法转化为带决策记录的计划。我知道大方向,但受众、范围和成功标准还不清楚。

About

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

Topics

Resources

Stars

119 stars

Watchers

8 watching

Forks

Releases

Packages

Contributors