1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Finding-Unknowns Skills |
| 作者/维护者 | Neeeophytee（个人开发者） |
| 来源链接 | https://github.com/Neeeophytee/finding-unknowns-skills |
| 许可证 | MIT（GitHub API 因文件内附加署名说明未能自动识别，人工核对 LICENSE 全文确认为标准 MIT） |
| GitHub Stars | 289（GitHub API） |
| Forks | 24（GitHub API） |
| 最新版本 | v1.3.0（GitHub Releases 标签，此前有 v1.1.0、v1.2.0） |
| 安装方式 | npx skills add、Claude Code / Codex 插件市场、手动复制、Hermes skills.external_dirs |
2. 功能介绍与亮点
Finding-Unknowns Skills 改编自 Anthropic Claude Code 团队成员 Thariq Shihipar 的两篇公开方法论文章，打包 11 个独立技能，覆盖“动手前 / 进行中 / 完成后”三阶段：
- 动手前：
blindspot-pass（摸排陌生领域盲区）、interview-me（一次只问一个架构级问题）、reference-hunt（用现成代码当规格书）、brainstorm-prototypes（生成可丢弃方案供取舍）、implementation-plan（优先呈现最可能被推翻的决策点）。 - 进行中：
implementation-notes记录每次偏离原计划之处。 - 完成后：
pitch-packager打包说服材料，change-quiz生成合并前理解测验。 - 上下文层：
context-audit揪出 CLAUDE.md 里的矛盾规则，agent-interface-design指导设计防误用的工具接口，progressive-disclosure拆分过长技能。
全部为纯 Markdown 指令，无脚本、无外部依赖，安装即用，且明确注明改编来源。
3. 适用场景
固定分类：元技能与 Agent 增强。
面向初中级 Claude Code / Codex / Hermes Agent 用户：进入陌生代码库或领域动手前先摸清认知盲区；需求仍有模糊地带需要被追问；CLAUDE.md/技能文件逐渐膨胀出现矛盾规则需要清理；团队合并代码前做理解自测。
4. 跨 Agent 兼容性
- Claude Code：原生支持。可通过插件市场一次装 11 个，或
npx skills add单独安装，斜杠命令/context-audit等直接触发。 - Codex：原生支持。README 注明已在 Codex CLI v0.143 实测验证，全部技能会被模型可见。
- Hermes Agent：原生支持。README 注明已在 Hermes Agent v0.15.1 实测验证，
hermes skills list显示全部 11 个技能为 enabled。 - OpenClaw：未验证——仓库文档未提及 OpenClaw，抓取材料中没有相关证据。
5. 推荐理由
“让 AI 先想清楚再动手”常年只是一句空泛建议。这套技能把它拆成 11 个可直接调用的具体步骤，并标明每步该在开发流程的哪个时间点使用，用结构化动作替代模糊提醒，降低因认知盲区导致的返工成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 289 GitHub Stars、24 Forks，仓库创建于 2026 年 7 月初、持续有更新提交；另通过了 awesome-claude-code 资源提交的自动校验，但未见独立第三方的活跃讨论帖 |
| 可用性 | 9 | 一条 npx skills add 命令跨 Claude Code / Codex / Hermes / Cursor 安装；配有 INSTALL-CODEX.md、INSTALL-HERMES.md、EXAMPLES.md 等完整文档；近期持续维护（v1.1.0 → v1.3.0）；无任何付费依赖 |
| 安全性 | 9 | 逐项见下方检查清单，纯提示词技能且无地板扣分项 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无——全部为 Markdown 指令，未发现任何脚本文件 |
| ② 运行时联网外发 | 无——纯提示词技能，不涉及网络请求 |
| ③ API key / 凭据 | 不需要 |
| ④ 可疑指令 | 抽查多个 SKILL.md 未发现 prompt injection 或隐蔽指令 |
| ⑤ 作者/组织信誉 | 个人开发者，身份可查（GitHub 用户 Neeeophytee）；内容注明改编自 Thariq Shihipar 公开文章，未见虚假宣传 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 近一周内仍有提交，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| Finding-Unknowns Skills | 11 个技能覆盖“动手前/进行中/完成后”全流程 | 每个阶段都有独立技能可单独调用，且额外覆盖 CLAUDE.md/接口设计层面的盲区排查 |
| neonwatty/claude-interview-skills | feature-interview、bug-interview、think-through 三个“动手前多轮提问”技能 |
只聚焦“提问”这一个动作、追求 5–10 轮苏格拉底式追问直到用户明确批准，颗粒度更细但不覆盖开发中记录、合并前测验等后续阶段 |
| Optim-Agent/optim-plans | 人机协作规划插件，把想法转成可审阅的 Markdown 计划并设执行关卡 | 核心产出是正式计划文档与强制执行门禁，偏“生成计划”而非“发现盲区”，更适合已经想清楚方向、需要流程管控的团队 |
8. 用户评价
该技能目前在 GitHub Issues 与常见社区平台尚无具名用户评价；已提交至社区维护的 awesome-claude-code 资源列表并通过其自动校验检查。
9. 其他补充
暂无多语言版本（全英文文档）。版本历史清晰可查：v1.1.0 → v1.2.0 → v1.3.0，欢迎以 Issue/PR 形式贡献。
10. 安装使用方式
方式一：一条命令装全部（推荐）
npx skills add Neeeophytee/finding-unknowns-skills加 --list 可先预览 11 个技能，加 --skill blindspot-pass 可只装其中一个。
方式二：Claude Code / Codex 插件
/plugin marketplace add Neeeophytee/finding-unknowns-skills
/plugin install finding-unknowns@finding-unknowns-skills方式三：Hermes Agent，在 ~/.hermes/config.yaml 中添加：
skills:
external_dirs:
- ~/finding-unknowns-skills/skills安装后无需重启，即可在对话中触发（Claude Code 用 /blindspot-pass 等斜杠命令，Codex 用 $blindspot-pass），模型也会按描述自动判断何时调用。progressive-disclosure 在 Claude Code 中仅限手动调用，需主动输入技能名触发；Codex 上该限制不生效。
11. 注意事项
- 内容为社区对公开文章的蒸馏改编，非 Anthropic 官方项目，方法论准确性依赖原文章与改编者的转述质量。
- 单一个人开发者维护，尚无多贡献者审核机制。
- OpenClaw 兼容性未经验证，如需使用建议先自行测试安装与触发流程。
progressive-disclosure在 Codex 上会始终作为模型可见技能加载，与 Claude Code 的“仅手动触发”行为不一致，跨平台使用需留意上下文占用差异。