用途:依据公开资料,build-bundle 用于为 product-lifecycle-templates 库端到端构建一个受治理的模板包(八份文件、过关、合并)。适用场景是向库中新增一个类型。
主要能力与流程:运行前需阅读 docs/internal/bundle-pipeline.md(六阶段运行手册、注意事项、校验片段、模型路由)与 docs/internal/review-standards.md(CI 已证明什么、其无法覆盖的七类缺陷、标准、视角范围),再阅读 buildout-specs.md 中的类型规范与 docs/internal/contracts/<family>.md 家族契约。开始前要求 main 干净、无未决 PR 并执行 git pull;类型需在构建待办中且家族契约已存在,否则停止(契约由维护者审阅,不可自行批准);目录条目需已存在。流程分六阶段:阶段 0-2 研究,按研究维度并行分发 agent 并合成一份研究日志;阶段 3 起草,运行 {stage:"draft", type, family},按依赖顺序生成七份文件;阶段 3.5 机器预读,运行 python tools/lint-number-provenance.py <type> 与 python tools/lint-unsourced-confidence.py <type> --uncited;阶段 4-5 四视角评审与应用;阶段 6 过关与落地,需在链接门禁前 git add,然后门禁、清单、链接、README 与 STATE 更新、PR、CI、合并。来源归属为规则:每个研究 agent 先执行 python tools/source-cache.py get <url>,退出 0 命中、1 未命中、2 过期(超过 14 天需重取),未命中则取回后写入;维度不拥有来源则不读其正文。
限制与成本:需维护者决定的事项包括范围、家族契约、版本发布、README 或公开文案中关于库的声明;其余由通过的 bundle PR 自行合并。完成标准为门禁通过、链接可解析、计数一致、CI 通过、PR 合并、main 拉取且 buildout-specs.md 进度表已更新。每个 bundle 约耗 700K-1M tokens,主要由研究分发与四视角评审构成。资料未提供具体收费与价格信息。