octocode-research

Octocode 研究

论断之前先找证据。找到锚点，读取精确字节，证明论断，然后作答或修复。

FRAME → CLASSIFY → MODEL → SEARCH → READ EXACT → PROVE → DECIDE/PATCH → VERIFY

这就是完整的流程，并非必须逐项执行的检查清单。根据论断调整流程：简单查询只需低成本读取，并如实标注置信度；删除、合并结论或根因分析则需要走完整流程。可以跳过已经能回答的阶段，但要说明跳过了哪些阶段。

规则

1. 开头用一行说明：语料库、实际情况与期望情况、任务类别、模式、使用和跳过的检索面。
2. 只有证据表明某项受支持的契约遭到违反时，才称之为 Bug。
3. 根因分析需要说明机制、触发条件、遭违反的契约、偏差边界，以及排除的另一种解释。
4. 使用你已掌握的最强线索。对于重要论断，检查以下三者中的两项：结构、流、连接关系。
5. 代码片段只是线索。结果为空，意味着此路径无法看到它，而不是它不存在。明确说明你指的是哪一种情况。
6. 追踪 claim → evidence → confidence → next check。引用精确锚点，且只列出实际执行过的检查。
7. 对宽泛契约、删除或重命名、证据薄弱的情况，或第三个无关搜索空间，先征求同意。证明之后再修复。

在以下情况停止：有依据的证据回答了界定的问题，且其他解释已被排除；没有成本低廉的后续步骤能改变结论；达到预算上限（默认进行 3-5 次决定性迭代，或约 15 分钟）；最后几次迭代没有改变任何状态；重试仍只能获得薄弱证据，或许可、产品、架构方面的决定应由用户作出；遇到阻断条件（宽泛契约、删除或重命名、克隆或运行不可信代码、未经批准写入制品）；或者技能修改的测量结果持平或更差——通过 references/improve-loop.md 回退。报告尚存的缺口，不要用冗长内容充斥答案来伪装确定性。

工作流

从 references/algorithm.md（路由、证据等级）和 references/problem-framing.md（这是 Bug、功能、增强，还是尚不确定？）开始。然后根据你正在查看的内容选择一条路径——如果需要各路径的详细说明、按任务规模划分的加载预算，或路径间的交接凭据，请加载 references/workflows.md：

情况	路径
当前仓库、工作区、已安装的依赖	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 或本地差异	references/workflow-pr-review.md
追踪连接关系——调用方、导入、引用、可达性	references/code-research.md

以上任一路径的证明深度：references/code-research.md。一般研究——跨代码、软件包、文档和历史进行映射 / 验证 / 调查 / 规划：references/research-flow.md。

审查分为三个部分：使用 references/workflow-pr-review.md 确定目标、准则和风险规模；接着使用 references/workflow-pr-review-analysis.md 确定分析深度、流程证明和问题描述形式；最后使用 references/workflow-pr-review-report.md 编写通过验证门控的建议，以及可选的书面文档。

只有确有需要时才参考这些内容：references/loop-mode.md（证据不断变化）、references/long-research.md（持久决策简报）、references/researcher-mindset.md（预算、扩展范围、研究计划）。

在当前步骤需要时再加载参考资料。一次性全部加载是失败的做法。

工具

优先使用可用的 Octocode MCP 工具。否则使用 npx octocode tools <name>——工具相同，共 15 个，架构相同，不会有任何损失。

npx octocode context --minimal                         # what's available
npx octocode tools <name> --scheme --json --compact    # read fields — never guess
npx octocode tools <name> --queries '<json>' --compact # run it

每次调用最多批量处理 5 个查询。先通过低成本操作（树、发现）确定方向，再进行精确读取。使用返回的 next.* 和游标，而不是重新推导。

如果传输方式、工具选择、身份验证、门控（ENABLE_LOCAL、ENABLE_CLONE、ENABLE_RELEASES）、物化、诊断或退出代码不明确，请阅读 references/octocode.md。

输出

发现 · 证据 · 置信度 · 下一步。决策还应包括结论、风险、精确锚点、验证方式和最小安全修复。报告信息缺口，不要夸大确定性。

相关内容

octocode-brainstorming（值得构建吗？） · octocode-rfc-generator（设计约定） · octocode-graph-eval（目标→KPI） · octocode-documentation（文档交付物） · octocode-skills（技能文件夹） · octocode-subagent（扇出） · octocode-roast（评审语气）。

更改此技能时，运行 node scripts/check-description.mjs（描述约定；使用 --help 查看标志），并通过 references/improve-loop.md 门控接受或回退。