迷雾地图术:dzhng/skills 的 explore-unknowns 如何用四象限拆解需求迷雾

原创2026-10-14 10:25:181,434 阅读

迷雾地图术:dzhng/skills 的 explore-unknowns 如何用四象限拆解需求迷雾

在 skills 项目(dzhng/skills,一套面向"软件工厂"的可复用 AI Agent 技能库)中,explore-unknowns 是一个专门拆解需求迷雾的技能:当你只有一句话需求("给我做个导出功能")时,它不急着写代码,而是像走地图一样带你过完四个象限——已知已知、已知未知、未知已知、未知未知,直到一张完整的需求地图交到你手上。它兼容 Claude Code、Codex 等 70 多种支持 skill 的 harness,本文用 5 个阶段完整讲清这套"迷雾地图术"。

🗺️ 为什么叫"迷雾地图":未知早发现和晚发现差一个数量级

技能的原始定义只有一句话就点破了本质:

The map is not the territory. The prompt, the plan, and the context window are the map; the codebase, the domain, and the user's actual intent are the territory.(提示词和计划是地图,代码库和你的真实意图才是领地。) —— SKILL.md

而迷雾的代价是:写代码前发现的未知只花几分钟,3 个 PR 之后才发现的未知要赔上那 3 个 PR。这正是 explore-unknowns 存在的意义——把战争迷雾(fog of war)在动手之前先探明。

explore-unknowns 四象限拆解需求迷雾:skills 项目 AI Agent 技能库的战争迷雾地图示意

技能还立下两条贯穿全程的规矩(SKILL.md):

  • Reacting beats imagining:不让你"描述你想要什么",而是递给你具体东西去反应——渲染出的选项、可点击的 mock、决策表格;
  • Every artifact assembles the reply:每个交付物结尾都预写好你的下一条回复(偷/跳过按钮、复选框、可粘贴的提示词),你的反应几乎零输入。

🧭 四象限地图:5 个阶段一次拆解

阶段 象限 要回答的问题 技能的做法
1 已知已知 哪些事已经定了? 静默扫描代码库,开场列出"已落定的地面"并附文件引用
2 已知未知 哪些问题必须回答? 一次只问一个,按影响面排序,每题自带推荐选项
3 未知已知 哪些答案你没说出口? 用真实数据渲染 4 种设计方向、可点击 mock 让你"看后才知道"
4 未知未知 哪些地雷还没被发现? 系统清扫任务触及的每个文件,产出地雷卡片
5 交图 地图完整了吗? 汇总四象限为一张自包含地图 + 可粘贴的实现提示词

阶段一:已知已知——先摆出"已落定的地面"

开场前,技能会先静默巡地(并行派子 agent 扫描任务触及的代码):已有什么半成品、数据形态、代码强制的约定。然后开场回复列出已理解的需求、代码钉死的事实(带文件引用)、既有约束与决策,并明确区分"已锁定"和"只是假设"。若扫描已发现改变任务性质的地雷,当场披露,不留到后面阶段。详见 stage-1-known-knowns.md。

阶段二:已知未知——只问你能命名的问题

这是"访谈"阶段,纪律性最强:

  • 一次只问一个问题,按"架构影响面"从大到小排序,绝不甩出一墙问题;
  • 每个问题都附推荐答案,做成 A/B/C 选项,几个字符就能回答;
  • 问题只能四种方式关闭:你回答了 / 代码(领地)回答了 / agent 经你授权代答 / 记为 OPEN 并写明解锁条件。

配套的偏好检查点很贴心:当你已回答五六题、偏好形成明显模式后,技能会暂停访谈,列出它推断的偏好,询问是否可以代答后续匹配问题——必须显式 opt-in,且每个代答都标注"问题 → 答案 → 依据的偏好",绝不藏起决定。详见 stage-2-known-unknowns.md。

阶段三:未知已知——挖出没说出口的"品味"

直接问"你想要什么"只能换来耸肩,因为口味和心照不宣的约定根本没法主动描述。所以这个阶段的手法全是"给你东西看":

  • 设计方向:同一份真实数据渲染 4 种互不兼容的设计,唯一变量是设计本身,适合"见了才知道"的用户;
  • 先 mock 后接线:用假数据做一个可点击的一次性原型,你一点就知道自己要点哪;
  • 教词汇:从你的大白话逐级搭到专业术语,每一级配上能解锁的精确提示词;
  • 具体样本:API 响应、文件格式,直接展示带标注的假数据成品,而不是让你想象"大概有哪些列"。

详见 stage-3-unknown-knowns.md。

阶段四:未知未知——清扫代码里的地雷

"你们都没想到要问的,领地(代码库)往往知道。"这个阶段遍历任务触及的每个文件,专找四类东西:默认就是错的数据、过期的冗余字段、放过坏行的过滤器、半途而废或已回滚的旧尝试(它们阵亡的原因通常就是你的地雷)。每条发现做成卡片:证据(文件+行号)→ 为什么咬人 → 任务要怎么变,最严重的排最前。详见 stage-4-unknown-unknowns.md。

阶段五:交图——地图才是交付物

收尾时,四个象限汇总成一张自包含的地图页:已落定事实(带引用)、决策台账(每个问题由谁关闭)、挖出的品味与隐性约定、地雷卡片(标注已决定 / OPEN / 尖刃),外加一份可粘贴的实现提示词,让开工变成一次粘贴。

关键纪律:地图交到你手上,探索才算结束;实现是另一个任务,在地图交付后才开始。 详见 stage-5-hand-over-the-map.md。

🔄 它在完整流程里的位置

explore-unknowns 是"大功能从头到尾"全流程的第一棒,你花在头尾两端,中间无人值守:

skills 完整流程:explore-unknowns 需求地图 → write-spec 规格 → 无人值守构建 → choices 决策审查

  1. 🗺️ Map the fog:/explore-unknowns 按象限访谈,产出完整地图(30 分钟~几小时);
  2. 📝 Codify:把地图交给 write-spec,决策大多已在上游做完,这步接近誊写;
  3. 🤖 Build:/goal /implement-spec specs/<feature> 开启循环模式,小功能几小时、大功能两三天;
  4. 🔍 Review the choices:不审 diff,审 choices.md——agent 在规格空白处做的每个决定,按"最没把握"排前面。

地图的生命不止于规划:构建期间的每次偏离、上线前的 buy-in 文档、合并前的理解测验,都在 after-the-walk.md 中给出打法。

⚡ 快速上手:安装与调用

一行命令安装(--list 可挑选单个技能):

npx skills add dzhng/skills

也可以克隆仓库后用脚本安装:

git clone https://gitcode.com/gh_mirrors/skills47/skills
cd skills && npm run install-skills

安装后在 Claude Code 或 Codex 中直接调用,需求越模糊越值得先跑它:

/explore-unknowns 给管理后台加一个可筛选、可导出的订单报表

📚 延伸阅读:值得看的路径

一句话总结:explore-unknowns 把"需求不清"从一种感觉变成一份有文件引用、有决策台账、有地雷坐标的地图——先探明迷雾,再开工,是这套软件工厂技能里最省钱的一棒。

登录后查看全文
skills