直接答案
把每个任务从仓库根路由到一个有明确所有者的包及其受影响依赖。加载根级全局规则和目录级命令,只提供沿依赖路径相关的上下文,限制可编辑路径,并使用仓库自身的依赖工具验证变更包和受影响消费者。
关键结论
- 根级说明定义全局策略,包级说明定义本地命令与约定。
- 上下文沿依赖链选择,不等于读取整个仓库。
- 实现前明确可编辑目录和生成文件规则。
- 验证必须覆盖受影响消费者,而不仅是变更包。
关键事实
这篇内容解决什么问题
建立符合 Monorepo 所有权、依赖和验收边界的编码代理工作流。
核验范围与限制
- 证据类型
- 官方文档本地验证
- 核验范围
- 覆盖任务路由、分层指令、上下文选择、编辑范围、依赖感知检查和跨包审查。
- 限制与失效条件
- - 受影响目标命令由具体 Monorepo 构建系统决定。
- - 静态依赖图可能遗漏运行、部署、数据和所有权耦合。
把任务路由到有所有权的包边界
从目标行为、负责团队、包、入口和可能消费者开始。代理先确认仓库布局和依赖路径,再提出修改;跨多个所有者的任务必须在编辑前暴露决策点。
记录生成目录、vendor、lockfile 和需要特殊审批的共享 schema,不能允许宽泛替换无方案地穿越包边界。
分层组织全局与包级说明
安全、依赖、发布与跨仓库规则放在根级;语言命令、包布局、测试目标和生成文件说明放在对应目录。不要复制同一规则到多个目录,否则很快漂移。
- 为每个命令注明工作目录。
- 标明包所有者和需要批准的文件。
- 说明生成制品及其源文件。
- 链接共享架构文档而不是复制全文。
围绕符号和依赖构建上下文
让代理沿目标路径搜索定义、调用者、测试和配置;大型生成文件和重复文件只摘要。稳定事实放在仓库说明,一次性验收要求留在当前任务。
上下文出现矛盾或过载时,用短状态摘要重启会话,不要在不确定历史上继续实现。
限制编辑并保护跨包契约
提供允许修改的包和文件清单。共享 schema、API、构建图、依赖版本或发布配置需要明确方案和相关所有者;必要改动超出边界时代理必须停止。
执行依赖感知验证
先运行变更包检查,再使用仓库维护的 affected 机制或消费者清单。共享边界变化时加入类型生成、契约检查和构建,并记录每条命令的正确工作目录。
- 01变更包运行格式化、类型检查与聚焦测试。
- 02共享边界按需重新生成并比较维护中的制品。
- 03依赖包运行仓库依赖图选出的检查。
- 04集成路径执行能观察契约的最小跨包流程。
按所有权审查并更新仓库上下文
请求变更包和共享边界所有者审查;命令或职责移动时同步更新分层说明。成功任务应让下一位维护者和代理更容易导航,而不是增加未文档化例外。
官方来源与核验范围
本文以公开官方文档为事实依据;命令和配置可能随客户端版本变化,执行前请同时核对对应来源。
查看技术核验方法