[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77824":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":10,"languages":10,"totalLinesOfCode":10,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":14,"starSnapshotCount":14,"syncStatus":16,"lastSyncTime":31,"discoverSource":32},77824,"Ask_Why","maxkura\u002FAsk_Why","maxkura","A codex planning mode enhancing skill，works better than codex planning mode.","https:\u002F\u002Fgithub.com\u002Fmaxkura\u002FAsk_Why",null,113,9,8,0,1,2,3,46.2,"MIT License",false,"main",true,[24,25,26,27],"agent","codex","planning","skill","2026-06-12 04:01:22","# Ask_Why.skill(十万个为什么)\n\n\n![Ask Why 概览](assets\u002Fask-why\u002Foverview.png)\n\nAsk Why 是一个面向 AI Agent 的 Skill，旨在通过多轮问答的方式增强Agent实现时的用户参与度，将设计者的意志的贯彻在Agent的执行过程中，来更好处理边界模糊的开放式规划任务，例如产品设计、研究计划、技术方案、PRD、工作流设计、Agent 设计和 Skill 设计。\n\n\nCodex \u002F Claude Code 在使用 Plan 模式处理产品设计、研究规划等复杂任务时，已经具备了一定的主动提问能力。\n\n但这类提问很多时候内容不够明确，选项解释不够清楚，用户虽然知道自己进行了选择，却不一定知道：为什么要选？这个选择会影响什么？当前方案还有哪些风险？有没有更好的方向？同时，这类提问不一定能覆盖方案的所有细节，他们自作主张地进行一些决定，最终导致反复的方案调整。\n\nAsk Why （十万个为什么）skills想解决的正是这个问题。\n它更强调问题的质量，旨在通过更优质更全面的问题，精准识别用户意图，帮助用户进行完整的计划、思考与选择：当前方案是什么？有哪些潜在弱点？还有哪些值得探索的方向？现在最应该做哪些决策？\n\n\nAsk Why 会把这些不确定性转化为一张张问题卡。用户得到的不只是一个最终方案，而是一条清晰、连续、可复盘的思考路径。最后实现一版方案满足用户需求。\n小时候，《十万个为什么》通过一个个“为什么”教我们认识世界；现在，Ask Why 用同样的方式，帮助我们把复杂计划想清楚：为什么这样？有没有别的可能？哪里可能不成立？换一个条件，结果是否会不同？\n\n\n小时候，《十万个为什么》通过一个个“为什么”教我们认识世界；现在，Ask Why 用同样的方式帮助我们把复杂计划想清楚：为什么这样？有没有别的可能？哪里可能不成立？换一个条件，结果是否会不同？\n\n**Ask Why 的目标不是替用户做决定，而是帮助用户把每一个重要决定想清楚。**\n\n## 适用场景\n\n适合使用 Ask Why 的情况：\n\n- 任务还很模糊，但早期方向会明显影响结果。\n- 有多个合理路线，需要用户做取舍。\n- 需求、边界、受众、成功标准或风险偏好还没有说清。\n- 你需要一份可追踪的计划，里面包含已确认决策、未解决问题和最终执行路径。\n- 你希望留下 `PLAN.md`、`DECISIONS.md`、`OPEN_QUESTIONS.md` 和 `FINAL_PLAN.md` 作为后续执行依据。\n\n不适合使用 Ask Why 的情况：\n\n- 简单事实问答。\n- 常规代码修复或直接执行任务。\n- 翻译、润色、一次性写作。\n- 用户已经给出完整规格，只需要实现。\n\n## 核心工作流\n\nAsk Why 不是把模糊需求直接包装成一个看似完整的答案，而是先判断是否真的需要追问，再用一轮轮可回答、可记录、可收敛的问题，把不确定性变成清楚的决策。\n\n进入 Ask Why 流程后，Skill 会：\n\n1. 通过 Entry Gate 判断任务是否值得进入追问模式。只有当任务模糊、用户偏好会影响结果、存在多个可行方向、错误选择会造成返工，并且用户愿意共同设计时，才会启动完整流程。\n2. 读取 `references\u002Fformats.md`，使用固定的状态文件、问题卡、阶段总结、草案和最终计划格式。\n3. 先理解任务，而不是直接给最终方案；同时建立模糊点地图，识别目标、受众、使用场景、交互粒度、平台环境、输出格式、成功标准、风险偏好和边界问题。\n4. 按重要程度把未知问题标记为 `P0`、`P1` 或 `P2`，区分哪些问题会阻塞后续设计，哪些会影响核心方案，哪些可以暂时延后确认。\n\n![Ask Why 思考路径](assets\u002Fask-why\u002Fthinking-path.png)\n\n5. 每轮提出 3 到 5 个聚焦的决策问题。每个问题都会尽量给出上下文、示例、选项、推荐和影响，而不是把一个空问题丢给用户猜。\n\n![Ask Why 决策问题卡](assets\u002Fask-why\u002Fdecision-card.png)\n\n6. 用户回答后，Skill 会同步更新 `PLAN.md`、`DECISIONS.md` 和 `OPEN_QUESTIONS.md`，把当前计划、已确认选择和未解决问题沉淀下来。\n\n![Ask Why 状态同步](assets\u002Fask-why\u002Fstate-update.png)\n\n![Ask Why 状态文件](assets\u002Fask-why\u002Fstate-files.png)\n\n7. 前三轮更偏发散：主动挑战假设，指出当前方案的潜在弱点，提供值得探索的替代方向。\n\n![Ask Why 发散与挑战](assets\u002Fask-why\u002Fdiverge-challenge.png)\n\n8. 每 2 到 3 轮进行一次阶段小结，帮助用户确认已经达成的共识、计划发生的变化，以及仍然悬而未决的问题。\n9. 从第四轮开始逐步收敛：减少不必要的扩展，优先解决真正影响执行的关键问题。当阻塞问题解决后生成计划草案；当剩余不确定性已经明确且不阻塞执行时，写出 `FINAL_PLAN.md`。\n\n![Ask Why 阶段小结与收敛](assets\u002Fask-why\u002Fconverge-summary.png)\n\n优先级含义：\n\n- `P0`: 阻塞设计，必须先回答。\n- `P1`: 会改变核心计划，应尽快确认。\n- `P2`: 可以暂时假设，后续再确认。\n\n## 状态文件\n\n默认情况下，Ask Why 会在可写环境中维护：\n\n```text\np2a-session\u002F\n|-- PLAN.md\n|-- DECISIONS.md\n|-- OPEN_QUESTIONS.md\n`-- FINAL_PLAN.md\n```\n\n- `PLAN.md`: 当前版本、目标、非目标、核心机制、工作流、输出、风险和下一阶段。\n- `DECISIONS.md`: 追加记录已确认选择、理由和计划影响。\n- `OPEN_QUESTIONS.md`: 跟踪未解决的 `P0`、`P1`、`P2` 问题。\n- `FINAL_PLAN.md`: 方向收敛后的最终计划。\n\n如果当前环境不可写，Skill 会使用相同标题在对话中维护这些状态。\n\n## 安装\n\n### 最简单的方式\n\n直接把下面这句话发给你的 AI 助手：\n\n```text\n帮我安装 Ask Why Skill，仓库地址：https:\u002F\u002Fgithub.com\u002Fmaxkura\u002FAsk_Why.git。请安装仓库中的 Ask_Why\u002F 子目录到当前 IDE\u002FAgent 的 Skill 目录。\n```\n\n注意：本仓库根目录是发布主页，真正的 Skill 包在 `Ask_Why\u002F` 子目录下。安装时请确保最终 Skill 目录里直接包含 `SKILL.md`。\n\n### 手动安装\n\n不同 IDE 或 Agent 常见的 Skill 目录：\n\n| IDE 或 Agent | Skill 目录 |\n| --- | --- |\n| Qoder | `.qoder\u002Fskills\u002FAsk_Why\u002F` |\n| Cursor | `.cursor\u002Fskills\u002FAsk_Why\u002F` |\n| Trae | `.trae\u002Fskills\u002FAsk_Why\u002F` |\n| Windsurf | `.windsurf\u002Fskills\u002FAsk_Why\u002F` |\n| Claude Code | `.claude\u002Fskills\u002FAsk_Why\u002F` |\n| Codex | `~\u002F.codex\u002Fskills\u002FAsk_Why\u002F` |\n| 通用 | `.agents\u002Fskills\u002FAsk_Why\u002F` |\n\n示例：安装到当前项目的通用 Skill 目录：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fmaxkura\u002FAsk_Why.git \u002Ftmp\u002FAsk_Why-skill\nmkdir -p .agents\u002Fskills\ncp -R \u002Ftmp\u002FAsk_Why-skill\u002FAsk_Why .agents\u002Fskills\u002FAsk_Why\n```\n\n示例：安装到 Codex 全局 Skill 目录：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fmaxkura\u002FAsk_Why.git \u002Ftmp\u002FAsk_Why-skill\nmkdir -p ~\u002F.codex\u002Fskills\ncp -R \u002Ftmp\u002FAsk_Why-skill\u002FAsk_Why ~\u002F.codex\u002Fskills\u002FAsk_Why\n```\n\n只要目标目录下直接有 `SKILL.md`，Agent 下次启动或刷新 Skill 列表时就可以加载它。\n\n## 使用\n\n触发名：\n\n```text\n$Ask_Why\n```\n\n默认提示词的中文含义：\n\n```text\n使用 $Ask_Why，把我模糊的产品、工作流、研究或技术想法转化为带决策记录的计划。\n```\n\n中文示例：\n\n```text\n使用 $Ask_Why，帮我把这个模糊的产品想法整理成可执行计划：我想做一个面向研究人员的文档标注工作流，但还不确定用户、功能边界和评估指标。\n```\n\n另一个示例：\n\n```text\n使用 $Ask_Why，把我模糊的研究工作流想法转化为带决策记录的计划。我知道大方向，但受众、范围和成功标准还不清楚。\n```\n\n## 仓库结构\n\n```text\n.\n|-- README.md\n|-- LICENSE\n|-- assets\u002F\n|   `-- ask-why\u002F\n`-- Ask_Why\u002F\n    |-- SKILL.md\n    |-- agents\u002F\n    |   `-- openai.yaml\n    `-- references\u002F\n        `-- formats.md\n```\n\n- `Ask_Why\u002FSKILL.md`: Skill 入口和核心工作流。\n- `Ask_Why\u002Freferences\u002Fformats.md`: 状态文件、决策问题、阶段总结、草案和最终计划的固定格式。\n- `Ask_Why\u002Fagents\u002Fopenai.yaml`: 面向 Skill 列表和默认提示词的展示元数据。\n- `assets\u002Fask-why\u002F`: README 使用的宣发配图。\n\n## 发布地址\n\nGitHub: https:\u002F\u002Fgithub.com\u002Fmaxkura\u002FAsk_Why.git\n\n## 许可证\n\n本项目使用 MIT 许可证，详见 [LICENSE](LICENSE)。\n","Ask_Why 是一个面向 AI Agent 的 Skill，通过多轮问答的方式增强用户参与度，帮助用户在处理边界模糊的开放式规划任务时做出更明智的决策。其核心功能包括提出高质量的问题，精准识别用户意图，并生成清晰、连续、可复盘的思考路径。Ask_Why 适用于产品设计、研究计划、技术方案等需要用户深度参与并进行复杂决策的场景。它通过一系列精心设计的问题卡，引导用户逐步明确需求、边界和成功标准，最终生成满足用户需求的方案。该项目采用 MIT 许可证，适合那些希望在规划过程中获得更多指导和透明度的用户。","2026-06-11 03:56:07","CREATED_QUERY"]