用途
Octocode Research 是一个用于深度代码调研的技术调查技能。当用户提出诸如“研究代码”“X 是如何工作的”“Y 定义在哪里”“谁调用了 Z”“追踪代码流程”“查找用法”等需求时,可调用该技能,对代码库与仓库进行探索,并给出以数据为依据、附带确切文件引用与行号的答案。其定位是“不假设,只探索”。
主要能力
- 分阶段(Phase 1–5)顺序执行调研流程,不允许跳过阶段(除非符合 fast-path 条件)。
- 先启动本地服务并加载系统提示与全部工具 schema,再据用户意图选择 prompt(research、research_local、reviewPR、plan、roast 等)。
- 具备 fast-path 评估:对“X 定义在哪里”“某函数做什么”这类单点、单文件、无歧义的查询,可直接进入研究;否则进入计划阶段。
- 计划阶段会识别研究领域、起草步骤、评估并行化,并以固定格式向用户展示研究计划、等待确认。
- 支持多领域并行调研:不同仓库、服务、语言或子系统的独立任务可并行启动子代理(如 Explore),再合并结果;单一领域则顺序执行。
- 运行研究循环:执行工具、先读响应中的 hints、向用户说明 hints、并据此决定下一步工具与动作。
- 提供错误恢复策略(空结果、超时、限流、死胡同、循环等)与上下文检查点机制,可将会话保存到 .octocode/research/{session-id}/ 并在需要时恢复。
- 记录会话文件(session.json、checkpoint、domain 输出、research.md)。
使用方式
从技能基础目录(系统消息中给出的 “Base directory for this skill: ...” 路径)运行: cd <SKILL_BASE_DIRECTORY> && npm run server-init 服务返回 “ok” 后再进入加载上下文阶段: curl http://localhost:1987/tools/initContext 随后按用户意图选择并加载 prompt: curl http://localhost:1987/prompts/info/{prompt} 执行工具调用使用 POST /tools/call/:toolName。若已安装 octocode-mcp 作为 MCP 服务器,可直接使用 octocode MCP 工具执行研究,服务初始化与上下文加载阶段仍然适用。日志位于 ~/.octocode/logs/(errors.log、tools.log)。
适用场景
- 代码库/本地代码探索与仓库分析。
- 外部库、GitHub 仓库、包的研究。
- PR 链接与评审请求的处理。
- 缺陷修复、功能开发、重构的实现规划。
- 追踪调用关系、代码流程、符号定义与用法。
- 跨仓库/跨服务/跨子系统的对比式调研。
限制
- 必须先启动本地服务并返回 “ok”,否则禁止调用任何本地研究工具。
- 禁止为必填参数编造值或使用占位符、猜测值;未知必填值需先用其他工具查明。
- 复杂任务须先向用户展示研究计划并获得明确批准后才能执行研究。
- 当存在多个独立领域时禁止顺序执行。
- 不得无限重试;重试耗尽后须停止并向用户报告。
- 具体收费、价格、支持平台与效果等资料暂未提供。