Neeeophytee/finding-unknowns-skills

# 发现未知技能 **8 个可安装的技能，让 Claude 帮助你发现你不知道的事情——在修复成本变得高昂之前。** 地图不是疆域。你的 prompt 是地图；代码库和真实世界是疆域。它们之间的差距就是你的*未知*，在使用强大的模型时，工作质量受限于你澄清未知的能力。这些技能将来自 [Thariq Shihipar 的](https://thariqs.github.io/html-effectiveness/unknowns/)文章《Fable 实战指南：发现你的未知》中的理念，转化为可以在 Claude Code、OpenAI Codex 或任何读取 [agentskills.io](https://agentskills.io) SKILL.md 格式的 agent 中运行的命令。 ## 一张表概括核心理念 | | **已知** | **未知** | |---|---|---| | **已知** | 你 prompt 中的内容 | 你知道自己尚未弄清楚的事情 | | **未知** | 显而易见，以至于你绝不会写下来，但一眼就能认出来 | 你完全没有考虑过的事情 | 下面的每个技能都是一种低成本的方法，用于在实现阶段导致成本高昂之前，将底层行中的内容移出。 ## 技能列表 | 技能 | 阶段 | 一句话描述 | |---|---|---| | [`blindspot-pass`](skills/blindspot-pass/SKILL.md) | 之前 | 在不熟悉的领域揭示你的未知，然后帮助你更好地编写 prompt | | [`brainstorm-prototypes`](skills/brainstorm-prototypes/SKILL.md) | 之前 | 提供你可以给出反馈的抛弃型变体，满足你无法言表的品味 | | [`interview-me`](skills/interview-me/SKILL.md) | 之前 | 每次只问一个问题，优先提出能改变架构的问题 | | [`reference-hunt`](skills/reference-hunt/SKILL.md) | 之前 | 使用可运行的源代码作为规范，甚至跨越不同语言 | | [`implementation-plan`](skills/implementation-plan/SKILL.md) | 之前 | 一份优先考虑你最可能改变决策的计划 | | [`implementation-notes`](skills/implementation-notes/SKILL.md) | 进行中 | 记录每一个偏离计划的偏差，以便下一次尝试能从中学习 | | [`pitch-packager`](skills/pitch-packager/SKILL.md) | 之后 | 将规范、原型和笔记打包成供审核者查阅的批准文档 | | [`change-quiz`](skills/change-quiz/SKILL.md) | 之后 | 你在合并前必须通过的阅读理解测验 | ## 安装 **一条命令，适用于任何 agent（推荐）：** Vercel 的 `skills` CLI 会自动检测你的编程 agent（Claude Code、Cursor、Codex、Copilot、Gemini 等），并将技能安装到每个 agent 对应的正确位置： ``` npx skills add Neeeophytee/finding-unknowns-skills ``` 添加 `--list` 以先预览这 8 个技能，或者使用 `--skill blindspot-pass` 仅安装一个。（可在 [skills.sh](https://skills.sh) 上发现。） **作为 Claude Code 插件安装（包含全部 8 个技能）：** ``` /plugin marketplace add Neeeophytee/finding-unknowns-skills /plugin install finding-unknowns@finding-unknowns-skills ``` **手动安装（选择你想要的技能）：** 将任何 `skills//` 文件夹复制到你项目的 `.claude/skills/` 目录中（如果是针对所有项目，则复制到 `~/.claude/skills/`）。 **单文件版本：** 如果你更希望将整个方法作为被动指导而不是命令使用，请将 [`CLAUDE.md`](CLAUDE.md)（适用于 Claude Code）或 [`AGENTS.md`](AGENTS.md)（适用于 Codex 及其他读取 AGENTS.md 的 agent）放入你的项目根目录，或将其附加到你现有的文件中。 ### 在 Cursor 中使用 上述的 `npx skills add Neeeophytee/finding-unknowns-skills` 命令会检测 Cursor，并自动为你将技能安装到 `~/.cursor/skills/` —— 无需手动步骤。（已验证：Vercel 的 CLI 会发现此仓库中的全部 8 个技能。） ### 在 OpenAI Codex 中使用 这些技能使用与 Codex 原生读取格式相同的 `SKILL.md`，因此无需转换。你可以运行 `npx skills add Neeeophytee/finding-unknowns-skills`（它会自动检测 Codex），或者将它们复制到 Codex 的技能目录中： ``` git clone https://github.com/Neeeophytee/finding-unknowns-skills cp -r finding-unknowns-skills/skills/* ~/.agents/skills/ # all projects # 或者，按项目： cp -r finding-unknowns-skills/skills/* your-repo/.agents/skills/ ``` Codex 会自动检测技能变更。对于被动指导版本，请将 [`AGENTS.md`](AGENTS.md) 放入你的项目根目录 —— Codex 在执行任何工作之前都会读取它。已在 Codex CLI v0.143 上测试：全部 8 个技能及其触发器描述都会加载到模型可见的 prompt 中（你可以通过 `codex debug prompt-input` 自行验证）。（路径参考 [Codex 技能文档](https://developers.openai.com/codex/skills)。） ## 何时使用哪个技能 - 刚接触代码库的某一部分，或一个全新的领域 → `blindspot-pass` - 一见便知（设计、UX、基调） → `brainstorm-prototypes` - 已经进行了头脑风暴，但仍然存在模糊性 → `interview-me` - 无法描述它，但某处的代码做得恰到好处 → `reference-hunt` - 准备好构建 → `implementation-plan`，然后让 `implementation-notes` 持续运行 - 构建完成 → 使用 `pitch-packager` 获取批准，在合并前进行 `change-quiz` 查看 [EXAMPLES.md](EXAMPLES.md) 获取真实的 prompt。 ## 致谢 相关技术和未知的框架理念来自 Thariq Shihipar 的文章及其[配套工件](https://thariqs.github.io/html-effectiveness/unknowns/)。本仓库将它们提炼为带有原创指令文本的 SKILL.md 格式；阅读原文章可了解完整的推论过程以及启发此理念的 Fable 5 发布视频的故事。报道来自：[The Decoder](https://the-decoder.com/anthropic-developer-shares-prompting-tips-for-fable-5-that-focus-on-finding-your-own-blind-spots-first/)。 ## 许可证 本仓库中的技能文本采用 [MIT](LICENSE) 许可证。底层技术归属于其作者；上文已注明出处。 _{与 [awesome-ai-workflows](https://github.com/Neeeophytee/awesome-ai-workflows)（一个由 CI 重新检查的 AI 工作流列表）和 [FlowStacks](https://flowstacks.xyz)（其中每个方案都带有机器验证徽章）一同维护。如果这个仓库对你有帮助，点个 star 可以帮助下一个人找到它。}

标签：AI智能体, AI编程助手, Claude Code, 代码生成, 开发效率, 提示词工程, 渗透测试工具, 策略决策点, 网络可观测性, 需求分析