SuperAPI AI 工具集

ork-explore

编程与开发

查看项目

更新于 10-16 04:17

技能介绍

用途

Ork Explore 用于在只读前提下,梳理一个陌生的代码库、功能、架构、数据流或运维路径,并输出以文件证据为支撑的映射结果。它适用于“这个系统是如何工作的”“某功能在哪里实现”“数据如何流转”这类探索性请求。

主要能力

  • 从任务边界、仓库说明、入口点和最小范围搜索入手,逐步证明执行路径。
  • 对每一项重要论断引用具体文件与符号,并区分已确认行为与推断。
  • 当路径经过第三方库或框架时,通过 context7 MCP 服务器读取其当前文档:先调用 resolve-library-id 获取库 ID,再调用 query-docs。该服务器仅暴露这两个工具。
  • 无法确认的 API 细节应归入未知项列表,而不是写入映射。
  • 默认在单一上下文中探索;仅当存在三个及以上相互独立的问题(如结构、数据流、测试、部署)时才并行展开。并行采用扁平结构,每个子任务有界且只读,要求返回简洁证据而非修复建议。
  • 已安装 ork_explorer 时优先使用,否则使用 Codex 内置探索器。

使用方式

以只读方式运行,不修改文件。先确定任务边界与仓库说明,定位入口点,用最小搜索验证执行路径。需要外部库信息时按上述 context7 流程查询文档。需要并行时按独立问题拆分,保持每个子任务有界、只读。

输出内容

返回一份紧凑的映射,包含:入口点、重要组件与依赖、测试与可观测性、风险或未知项,以及下一步最小调查。除非被明确要求,否则不把映射转化为实施计划。

适用场景

  • 接手陌生代码库,需要快速理解结构与关键路径。
  • 排查某功能或数据流的实现位置与依赖关系。
  • 梳理运维路径,识别风险与未知项。

限制

  • 保持只读,不修改文件,不主动产出实施计划。
  • 无法确认的 API 细节只能列为未知项。
  • 并行探索仅限三个及以上相互独立的问题,且必须保持有界、只读。
  • 关于收费、价格、平台支持范围等具体信息,资料暂未提供。