用途：Octocode Research 是一个代码调研技能，面向深度代码探索、仓库分析与实现规划。它强调不臆测、只探索，输出以精确文件引用和行号为依据的答案。适用于“研究代码”“X 如何工作”“Y 在哪定义”“谁调用 Z”“追踪代码流”“查找用法”等请求。
主要能力：按顺序执行五个阶段——初始化、加载上下文、快速路径评估、规划、研究与输出。支持外部库/GitHub 仓库/包调研（research）、本地代码库探索（research_local）、PR 审查（reviewPR）、缺陷修复与功能重构规划（plan）以及代码吐槽（roast）。工具响应会给出提示，需先解读提示再决定下一步工具。多独立领域时要求并行启动 Task 子代理，单领域则顺序执行。
使用方式：需先启动本地服务，从技能基础目录运行 cd <SKILL_BASE_DIRECTORY> && npm run server-init，返回 ok 后才能继续。随后用 curl http://localhost:1987/tools/initContext 加载上下文，选择并加载对应提示，再按规划执行研究。简单单点查找可走快速路径跳过规划。研究过程可保存检查点至 .octocode/research/{session-id}/checkpoint-{N}.md，日志位于 ~/.octocode/logs/。
适用场景：跨仓库或跨服务追踪调用链、定位符号定义、理解实现流程、对比不同库的状态管理等。
限制：服务未返回 ok 前禁止调用研究工具；不得为必填参数编造或使用占位值；不得忽略工具提示；不得在无完成触发条件时随意结束研究；输出必须带 file:line 证据。端口 1987 被占用时需先终止旧进程。具体收费、价格与平台支持情况暂未提供。