Octocode Research 是一个以证据为核心的代码研究技能，适用于“代码必须被核查而非假设”的场合，例如追踪调用者、导入、跨仓库连接、修改影响面，定位行为，绘制系统结构等。
用途 该技能的核心主张是“证据先于断言”：先找到锚点，读取确切字节，证明结论，然后再回答或修补。它把研究过程描述为 FRAME → CLASSIFY → MODEL → SEARCH → READ EXACT → PROVE → DECIDE/PATCH → VERIFY，但强调这不是必须逐项走完的清单，而应按断言规模伸缩：小查询只需廉价读取并诚实标注置信度；删除、合并判定或根因分析则需要完整流程。可以跳过已能回答的阶段，但要说明跳过了哪些。
主要能力
- 规则约束：开头用一行说明语料、实际与期望、任务类别、模式、使用与跳过的表面。只有证据显示受支持的契约被违反时才称为 bug。根因需要机制、触发条件、被违反的契约、分歧边界和被排除的替代解释。
- 证据追踪：记录 claim → evidence → confidence → next check，引用确切锚点，只记录实际运行过的检查。
- 停止条件：当有依据的证据回答了框定问题且替代解释已排除、没有廉价下一步能改变结论、预算耗尽（默认 3-5 次决定性迭代或约 15 分钟）、最后迭代未改变状态、重试仍薄弱、或遇到需要用户决策的许可/产品/架构问题、门禁阻塞（广泛契约、删除/重命名、克隆或运行不可信代码、未批准的产物写入）、技能编辑效果持平或更差时停止。报告剩余缺口而非填充确定性。
使用方式 先阅读 references/algorithm.md（路由、证据等级）和 references/problem-framing.md（判断是 bug、功能、增强还是未知），再根据所看对象选择路线：本地仓库/检出/已安装依赖用 references/workflow-local.md；外部仓库、npm 包、上游项目用 references/workflow-external.md；跨仓库连接、本地线索到上游、需要 AST/LSP 证明的远程代码用 references/workflow-combination.md；对多个候选仓库/包进行生态排名用 references/github-landscape.md；故障根因用 references/workflow-debug.md；规划编码流程、实现、迁移、修补行为用 references/workflow-change.md；重塑结构或命名并保持行为用 references/workflow-refactor.md；变更后验证、审查 PR 或本地 diff 用 references/workflow-pr-review.md；追踪调用者、导入、引用、可达性用 references/code-research.md。PR 审查分三部分：workflow-pr-review.md 确定目标、指南和风险规模；workflow-pr-review-analysis.md 确定深度、流程证明和发现形态；workflow-pr-review-report.md 给出验证门控的建议和可选书面文档。仅在确有需要时使用 loop-mode.md、long-research.md、researcher-mindset.md。按当前步骤需要加载参考，全部加载是失败模式。
工具 优先使用 Octocode MCP 工具；否则用 npx octocode tools <name>，同样 15 个工具、同样 schema。示例命令：npx octocode context --minimal；npx octocode tools <name> --scheme --json --compact；npx octocode tools <name> --queries '<json>' --compact。每次调用最多批量五个查询。先廉价定位（树、发现）再精确读取。跟随返回的 next.* 和游标，不要重新推导。当传输、工具选择、认证、门禁（ENABLE_LOCAL、ENABLE_CLONE、ENABLE_RELEASES）、物化、诊断或退出码不清楚时，阅读 references/octocode.md。
输出 输出格式为 Finding · Evidence · Confidence · Next。决策类输出增加 verdict、risks、确切锚点、验证和最小安全修复。报告缺口而非填充确定性。
适用场景 适用于需要核查代码事实、追踪连接、定位行为、映射系统、调试根因、规划变更、重构、PR 审查等场景。
限制 资料未提供具体收费、价格、平台支持范围、效果保证等信息。该技能依赖 Octocode MCP 工具或 npx octocode 命令，相关认证、门禁和运行环境要求需参考其文档。