finding-unknowns-skills Skill:让 Claude 在烧钱前先找出盲区的 11 个技能
让 AI 在”盲区”烧钱之前,先把它们找出来。
finding-unknowns-skills 是一套 11 个可安装的 Claude Code / Codex / Hermes 技能,专注于在实现之前识别”未知未知”——那些你根本没意识到自己不知道的东西。思路源自 Anthropic 技术作家 Thariq Shihipar 的两篇Essay,核心论点是:强模型时代,prompt 是地图,代码库和现实世界是领土,两者之间的缝隙就是你的盲区,而盲区越少,工作质量越高。
功能与原则
这套技能围绕”任务前→任务中→任务后”三个阶段设计,每个阶段都有对应的命令级 Skill:
Before(做之前):blindspot-pass、brainstorm-prototypes、interview-me、reference-hunt、implementation-plan — 目标是减少认知盲区,让 prompt 地图更接近实际领土。
During(做之中):implementation-notes — 记录每一次偏离计划的决定,为下一次迭代积累学习。
After(做完之后):pitch-packager、change-quiz — 把产出打包成买账文档,或用理解测验验证合并前是否真正掌握。
另外三个横跨所有任务的元技能(context-audit、agent-interface-design、progressive-disclosure)作用于 Agent 的系统层指令,解决”上下文里埋了 80% Anthropic 已删掉的 prompt 但没人知道”的问题。
认可度
GitHub 搜索显示 2026 年 7 月刚出现在搜索结果前列,属于新晋 trending 的 skill 类仓库,未见大规模 star 累计记录(社区项目冷启动期)。在 Claude Code Skills 社区(GitHub search: skill+agent+claude+created:2026-07)的 3.3k 结果中排名靠前,显示有真实的开发者活跃度。
链接
GitHub:https://github.com/Neeeophytee/finding-unknowns-skills
原作者
Neeeophytee — 社区开发者,专注将学术论文/技术博客的方法论转化为可安装的 SKILL.md 格式。无官方 Anthropic 背书,属社区自发蒸馏。
介绍
「地图不是领土」——这是这套 Skill 的认知起点。一个 prompt 是你脑子里的地图;代码库、第三方库、业务逻辑是实际领土;两者之间的 gap 就是「你不知道你不知道的东西」(Unknown Unknowns)。强模型可以弥补一些,但高质量工作的上限取决于 prompt 地图有多接近真实领土。
Thariq Shihipar 在 A Field Guide to Fable: Finding Your Unknowns 中完整阐述了这个框架,并被社区开发者 Neeeophytee 转化为 11 个可直接安装的 Skill。随后在 The new rules of context engineering for Claude 5 generation models 中,Shihipar 又将思路提升一个层次:不仅找单个 prompt 里的盲区,还要清理每个 prompt 都继承的那个”上下文层”——也就是 CLAUDE.md 和各种 skill 文件里积累的隐性规则。
finding-unknowns-skills 就是这两篇 Essay 的工程化实现。
特点
- 11 个独立 Skill,按任务阶段分组:Before / During / After + 系统层,无需全部安装,按需挑选
- 通用 SKILL.md 格式:兼容 Claude Code、OpenAI Codex、Kimi Code CLI(Kimi K3)等所有读取 agentskills.io 规范的 Agent
- one-command 安装:
npx skills add Neeeophytee/finding-unknowns-skills,自动识别并装入正确路径 - Claude Code 插件模式可用:
/plugin marketplace add+/plugin install即可在 Claude Code 里直接调用 - 轻量级:也可只复制
guidance/finding-unknowns.md到项目根目录作为 CLAUDE.md / AGENTS.md,完全不进入命令模式
使用方法
推荐安装(Vercel skills CLI,自动识别 Agent):
npx skills add Neeeophytee/finding-unknowns-skills
预览全部 Skill 列表:
npx skills add Neeeophytee/finding-unknowns-skills --list
只安装其中一个 Skill(如 blindspot-pass):
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass
Claude Code 插件模式:
/plugin marketplace add Neeeophytee/finding-unknowns-skills
/plugin install finding-unknowns@finding-unknowns-skills
手动安装:复制 skills/<name>/ 文件夹到项目 .claude/skills/ 或 ~/.claude/skills/(全局)。
调用 blindspot-pass 示例(进入陌生代码区前):
/blindspot-pass
Agent 会问两个问题:你要做什么 + 你在这个领域的经验水平,然后探索目标模块、历史记录、代码约定,返回四个部分:Landmines(典型错误)、Hidden context(已做出的约束性决策)、What good looks like(2-3 个做得好的参考)、Questions you should be asking(专家会问的 3-5 个问题)。
使用场景与人群
适用场景:进入陌生代码库、接手新项目、跨领域开发(前端工程师做基础设施、设计背景做前端)、Code Review 前自检、重要发布前的最后一轮检查。
目标用户:使用 Claude Code、OpenAI Codex 或类似 Agent 的开发者,尤其是感觉”prompt 写得不错但实现出来不对劲”的从业者。
输入与输出案例
场景 1:进入陌生领域
输入(用户):我要给这个 React Native 项目加支付模块,但从来没做过移动端
输出(Agent):
- Landmines:
· iOS 和 Android 的支付 API 签名流程不同,不能直接复用同一套逻辑
· 苹果要求所有数字商品必须用 IAP,不能跳转到外部支付
· ...
- Hidden context:
· 项目已有 react-native-purchases 但版本是 3.x 最新是 5.x
· App Store Connect 需要单独配置沙盒测试账号
· ...
- Questions you should be asking:
1. 订阅制还是一次性购买?(影响 IAP vs 外部支付选择)
2. 需要支持哪些平台?(iOS/Android/Cross-platform)
...
场景 2:Context Audit(元技能)
运行 context-audit Skill,它会扫描你的 CLAUDE.md 和所有 skill 文件,找出矛盾、重复和已失效的规则,然后告诉你哪些可以安全删掉——解决的是”上下文越来越臃肿但没人敢删”的典型困境。
GitHub: https://github.com/Neeeophytee/finding-unknowns-skills
评论区
登录后可评论。