用途
wiki-research 是一个“Wiki 优先研究协议”（Wiki-First Research Protocol）技能。它要求在任何代码库探索、深入仓库调查或阅读原始源码之前，先读取项目自带的 Obsidian 风格 wiki（index.md + wiki/）。其所依据的前提是：Obsidian 风格 wiki 是从原始资料综合编译、并做了交叉链接的知识库，读取它比重新阅读原始资料便宜一个数量级，也比用笨办法重新推导理解更快。
主要能力
- 成本分层指导：技能给出不同读取方式的典型 token 消耗：扫描 index.md 约 300–600 token；单个 entity/concept 页面约 300–800 token；单个 source 页面约 600–1,500 token；一个原始源码目录（10–14 篇文档）约 30,000–200,000 token；完整代码库探索 200,000–500,000+ token。
- Wiki 检测：提供命令检查项目根目录是否存在 wiki 结构，或从 CLAUDE.md 中查找 wiki 路径声明。若未找到 wiki，则跳过该协议，回到常规探索；若找到 wiki，则继续。
- 定向阅读：读取作为导航层的 index.md，寻找与任务相关的 entity、concept、source 条目，然后只读取 2–4 个最相关页面；overview 页面仅用于获取整体生态背景，source 页面仅用于追溯研究来源或原始文档位置。
- 按需升级：若 wiki 已覆盖问题即结束；若存在缺口（页面标记“尚未记录”、存在矛盾或未覆盖具体问题），则查阅相关 source 页面的原始文档指针，只读被指向的具体文件，而非整个目录，缺口填补后回到任务；若主题完全不在 wiki 中，则查看 CLAUDE.md 的源码映射，以 grep/glob 优先进行定向探索。
- 页面结构约定：说明 wiki 页面通常包含标题、类型（entity/concept/comparison/source/overview）、标签、来源，以及开头一段摘要和 Related 链接区；开头段落往往足够，其余章节可按需选读。
- 目录布局与外部 wiki：给出标准 wiki 根目录布局（index.md 与 wiki/ 下的 overview.md、entities/、concepts/、comparisons/、sources/）；说明 wiki 位于独立仓库时，项目 CLAUDE.md 应声明外部根路径，并相应替换检测命令；还说明多知识簇 wiki 中应限制在任务所属簇内阅读，避免跨簇消耗 token。
- 反模式清单：列出了先读原始源码目录、跳过 index.md、盲目跟随所有 Related 链接、忽略 CLAUDE.md 中声明的 wiki 等错误做法及替代做法。
- 参考资料：references/contradiction-finding.md，用于在综合 3 个以上来源、写总结前，暴露来源之间的分歧。
使用方式
按照技能描述，使用流程为：先用命令检测 wiki 是否存在（例如 ls index.md wiki/ 或 grep CLAUDE.md 中的 wiki 路径声明）；随后必读 index.md，定位任务相关条目；再读取 2–3 个目标页面，按需查看 source 页面；只有当 wiki 存在缺口时，才依据 source 页面指针读取具体原始文件；读到能回答问题即停止。
适用场景
适用于已建立研究型 wiki 的软件项目，尤其是将 wiki 放在独立仓库、或在 CLAUDE.md 中声明 wiki 位置的项目；也适用于包含多个互不相关知识簇的 wiki，此时应只读任务所属簇的页面。没有 wiki 的项目不适用，应直接跳过该协议。
限制
该技能假设项目采用上述标准目录布局；若项目使用扁平 docs/、GitBook、MkDocs、Docusaurus 等不同约定，协议仍适用但文件路径会改变，需先阅读 CLAUDE.md 或顶层文档索引了解结构。外部 wiki 与多簇 wiki 的行为依赖项目在 CLAUDE.md 中的声明。