Files
virtual-company/docs/03-product-pipeline.md

54 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 03 产品迭代产品线(多代理分工)
单产品线从「单代理循环」升级为「分工流水线」的完整设计。运行实例:temp/UI 仓库。
## 核心命题转变
单代理循环的瓶颈是**单点产能**;多代理产品线的瓶颈是**协调 + 质量不退化**。
## 五层结构
1. **调度中枢**:任务队列与分片 / 并发锁与心跳 / token 预算与熔断;
2. **点子工厂(PM)**:选题 + 可验证的验收标准;
3. **架构拆解**:任务分片 + 接口定义;
4. **工程池 × N**:并行实现,各自独立工作区;
5. **质检 + 发布**:交叉评审 + 合并队列。
## 任务分片原则(并行的前提)
- 按文件域切片:新增独立文件的任务可并行;
- 公共文件(导出表、manifest、演示页)是冲突域,汇总到串行尾部统一合入;
- 判据:两个任务的 diff 无交集才可并行。
## 隔离与合并队列
- 每个工程师代理在独立 `git worktree` 工作(同一仓库的平行工作目录),互不污染;
- 完成品不直接进集成分支,进入**合并队列**按序 fast-forward——多车道汇入单出口;
- 队列保证同一时刻只有一条车道在合并,冲突在队列内串行暴露、逐个解决。
## 三级质量闸门链
```
提交(独立 probe 分支)
→ 静态门禁(规范检查 + 类型检查)
→ 测试门禁(冒烟断言 + 演示可运行)
→ AI 交叉评审(独立代理,只看 diff 与验收标准)
→ 合并队列 → 集成分支
任意一道不过 → 淘汰池(回炉重做;同方向连续 3 次失败 → 拉黑)
```
交叉评审的存在意义:解决单代理「自己检查自己必然通过」的根本缺陷。
## 运行模式:连续迭代 + 心跳监护
- 调度器**不是**迭代器,只做健康检查与中断重启(高频唤起、零成本退出);
- 真正迭代是单次唤起内的连续循环:逐条消化任务直到清空或时间预算耗尽;
- 并发锁 + 心跳:锁文件时间戳超时视为循环崩溃,删锁重新点火;
- 熔断:同一任务连续 2 轮失败即放弃留痕,防止死循环烧 token。
## 点子再生(工作不停歇的源头)
PM 代理持续从四个水源补给任务:用户反馈与 issue、代码扫描(TODO/坏味道/缺口测试)、生态对标、文档与演示缺口。每条任务必须带可验证的验收标准才能入队——质量在需求端的第一道滤网。
架构图:[diagrams/product-pipeline.svg](diagrams/product-pipeline.svg)、[diagrams/quality-gates.svg](diagrams/quality-gates.svg)