背景 / Background
我的使用场景是后端微服务架构:在一个工作目录(如 /work)下存在多个子项目,每个子项目是一个独立的 git root,而 /work 目录本身不是 git root。开发一个需求时,我通常在 /work 下启动 AI Agent,修改代码会涉及多个项目(微服务)联动。
Reading the README, AOCI-CODE 的索引范围目前强依赖 Git:scan takes its file inventory from Git,并以单个 repository 为治理单位(aoci --repo /absolute/path/to/repository)。这与「多 git root 容器目录 + 跨项目联动开发」的场景适配度不足,主要遇到以下三个问题。
问题一:包含多个 git 仓库的目录无法建立索引
/work 本身不是 git root,无法对其执行 scan(取不到 Git 文件清单);而若分别在每个子项目内各自 init/scan,会得到多份相互独立的 Whole-Index,无法表达「跨微服务的整体系统认知」——而这正是多项目联动开发时最需要的。
期望:支持以「容器目录」为治理根,把其下多个独立 git 仓库纳入同一份 Whole-Index(multi-repo / workspace 级别的索引),同时保留各子项目的 git 边界。
问题二:不能灵活指定只对某些项目/文件建立索引(强依赖 .gitignore)
当前 Managed Scope 主要靠 .gitignore 做排除式控制(README 也强调不要把 aoci 资产加入 .gitignore,否则被静默跳过),缺少正向、显式的「只索引这些项目/这些文件/这些路径」的 include 机制。
期望:提供正向的 scope 配置(include/exclude 路径、项目、glob),能显式声明「只对哪些子项目/哪些目录/哪类文件建立索引」,而不是只能靠 .gitignore 间接排除。
问题三:希望支持渐进式索引(progressive / incremental indexing)
对已经存在的大型项目,一次性建立全量索引耗时巨大(README 说约 1 小时 / 20 万行,且要消耗大量 token)。我希望初期可以只指定少量代码建立索引,在后续需求开发迭代过程中持续增加索引范围,最终渐进式达到全量索引。
现有的 scan 是「一次性建立 Managed Baseline」,--force 也不能作为重新定义治理事实的捷径(README 明确说明)。缺少「从一个小子集起步、随开发逐步扩面」的渐进式建索引路径。
期望:支持渐进式建索引——初始只索引少量指定文件/模块,后续随迭代持续追加范围,直至覆盖全量代码;中间各阶段都保持可用且 aligned 的认知。
当前最佳实践与场景不适配
综上,AOCI-CODE 当前的最佳实践更面向「单一 git 仓库、一次性全量认知」的形态,而我的场景是「多 git root 容器目录 + 跨项目联动 + 已有大型存量代码渐进式接入」,三者目前都缺少顺畅的路径。
希望 aoci-code 能考虑上述场景的支持。感谢!
背景 / Background
我的使用场景是后端微服务架构:在一个工作目录(如
/work)下存在多个子项目,每个子项目是一个独立的 git root,而/work目录本身不是 git root。开发一个需求时,我通常在/work下启动 AI Agent,修改代码会涉及多个项目(微服务)联动。Reading the README, AOCI-CODE 的索引范围目前强依赖 Git:
scan takes its file inventory from Git,并以单个 repository 为治理单位(aoci --repo /absolute/path/to/repository)。这与「多 git root 容器目录 + 跨项目联动开发」的场景适配度不足,主要遇到以下三个问题。问题一:包含多个 git 仓库的目录无法建立索引
/work本身不是 git root,无法对其执行scan(取不到 Git 文件清单);而若分别在每个子项目内各自init/scan,会得到多份相互独立的 Whole-Index,无法表达「跨微服务的整体系统认知」——而这正是多项目联动开发时最需要的。期望:支持以「容器目录」为治理根,把其下多个独立 git 仓库纳入同一份 Whole-Index(multi-repo / workspace 级别的索引),同时保留各子项目的 git 边界。
问题二:不能灵活指定只对某些项目/文件建立索引(强依赖 .gitignore)
当前 Managed Scope 主要靠
.gitignore做排除式控制(README 也强调不要把 aoci 资产加入 .gitignore,否则被静默跳过),缺少正向、显式的「只索引这些项目/这些文件/这些路径」的 include 机制。期望:提供正向的 scope 配置(include/exclude 路径、项目、glob),能显式声明「只对哪些子项目/哪些目录/哪类文件建立索引」,而不是只能靠 .gitignore 间接排除。
问题三:希望支持渐进式索引(progressive / incremental indexing)
对已经存在的大型项目,一次性建立全量索引耗时巨大(README 说约 1 小时 / 20 万行,且要消耗大量 token)。我希望初期可以只指定少量代码建立索引,在后续需求开发迭代过程中持续增加索引范围,最终渐进式达到全量索引。
现有的
scan是「一次性建立 Managed Baseline」,--force也不能作为重新定义治理事实的捷径(README 明确说明)。缺少「从一个小子集起步、随开发逐步扩面」的渐进式建索引路径。期望:支持渐进式建索引——初始只索引少量指定文件/模块,后续随迭代持续追加范围,直至覆盖全量代码;中间各阶段都保持可用且 aligned 的认知。
当前最佳实践与场景不适配
综上,AOCI-CODE 当前的最佳实践更面向「单一 git 仓库、一次性全量认知」的形态,而我的场景是「多 git root 容器目录 + 跨项目联动 + 已有大型存量代码渐进式接入」,三者目前都缺少顺畅的路径。
希望 aoci-code 能考虑上述场景的支持。感谢!