用途：octocode-loop 用于在目标与路径已明确时，执行有依据的迭代研究循环（Act→Observe→Learn→Repeat）。每一步都必须以真实的 Octocode 工具结果作为观察依据，而非假设；当证据收敛或触及预算时停止。
主要能力：支持三种模式——通用研究循环、本地代码检查与发现循环、跨本地+GitHub+npm+历史+网页的多源完整研究循环。核心原则是每轮迭代必须以带状态的真实结果收尾，下一步动作由该观察决定。
使用方式：可通过 MCP 或 CLI 两种传输方式使用。宿主提供 Octocode MCP 工具时使用 oqlSearch、ghSearchCode、ghViewRepoStructure、ghGetFileContent、ghSearchRepos、npmSearch、ghHistoryResearch 等；否则使用 CLI（octocode <cmd>，未安装时用 npx octocode）。循环步骤为：Frame（一行目标与本次要解决的问题）、Act（发出一个最小成本的调用）、Observe（先读状态：empty 表示无匹配，需检查范围、拼写、分支、提取模式；error 需修正调用后重试；有结果则记录精确锚点如 path:line、repo/PR/package id、branch）、Learn（更新假设图，选择下一个最省成本的步骤）、Repeat 直至通过停止测试。
停止条件：多个退出条件任一触发即停——问题已由有依据的证据回答且备选被排除、最省成本的下一步无法改变结论、迭代或 token 预算耗尽、或检测到无进展。停止前需做一次反思：最弱主张、最强反证、是否还有一次廉价调用可翻转结论。
输出契约：以紧凑结果收尾，包含 Answer、Evidence（锚点）、Loop trace（仅关键迭代）、Verification（实际运行的确定性检查，或说明无）、Open gaps。
限制与门槛：运行某模式前需先读对应参考文件，首次原始工具/模式调用前需读 references/tools.md。结论必须先用确定性检查（测试、构建、AST/结构匹配、LSP、精确读取、历史）证明，LLM 判断仅用于不可量化项。昂贵或不可逆操作（克隆、测试运行、任何写入）需以存活的线索为前提，并在不可逆操作前与人工确认。资料未提供具体安装步骤、收费与平台信息。