SuperAPI AI 工具集

brownfield

通用与其它

查看项目

更新于 10-16 04:54

技能介绍

用途:扫描根目录下已有的 Git 仓库和链接工作树,并管理在访谈(interviews)中作为上下文使用的默认仓库。

主要能力:

  • 扫描:查找扫描根目录下最多两层深度的 Git 仓库与工作树,本地仓库、无远程仓库或远程名非 origin 的仓库均可注册。点号开头目录及 node_modules 等噪声目录不作为种子位置遍历。工作树家族不会展开,只有遍历直接发现的工作树才注册。
  • 默认管理:查看当前默认、按编号设置默认、清空默认。
  • detect:对目标目录执行一次 AI 调用,生成 .ouroboros/mechanical.toml,写入经校验的 lint/build/test/static/coverage 命令;该文件是评估 Stage 1 的权威契约。

使用方式:

  • ooo brownfield:扫描并设置默认
  • ooo brownfield scan:仅扫描
  • ooo brownfield defaults:显示当前默认
  • ooo brownfield set 6,18,19:按仓库编号设置默认
  • ooo brownfield detect [path]:生成 mechanical.toml
  • detect 也可用命令:uvx --python '>=3.12' --from ouroboros-ai ouroboros detect [path],或已安装时 ouroboros detect [path] [--force]

实现要点:扫描与默认设置通过 MCP 工具 ouroboros_brownfield 完成,调用前需重新执行工具发现查询 "+ouroboros brownfield";默认选择以纯文本回复收集,不使用 AskUserQuestion。

适用场景:需要在访谈中引入现有代码库上下文,或为评估预先生成/刷新构建、测试等命令配置。

限制:扫描深度最多两层;不展开工作树家族;detect 可能因未找到清单、LLM 不可用或所有提案被丢弃而无法提出可验证命令,此时需手写最小 toml。具体收费、平台与效果资料暂未提供。