用途:扫描根目录下已有的 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。具体收费、平台与效果资料暂未提供。