对 LemonBoss 的映射 · LemonBoss PRD

能力映射总表

能力	新组件	对应现有模块	改动
Agent 启动与会话复用	—	`packages/acp-core/protocol/ClaudeCliProtocol.js` + `server/src/core/session-pool.js`	REUSE
多 Agent 调用 facade	—	`server/src/core/agent-manager.js` · `master-session.js`	REUSE
任务 → 步骤拆分	—	`server/src/tools/orchestrate-tool.js`	REUSE
DAG 依赖解析	—	`server/src/core/scheduler.js` (`getExecutionGroups`)	REUSE
Pipeline 描述结构	—	`server/services/pipeline-service.js`	REUSE · units.json 复用 step 结构
重试 + 反思	`retryWithReflection()` 写在 loop-controller.js 内	参考 `server/services/evolution-loop.js` (PRAE) 思路，但不抽公共	NEW · P5 再考虑合并
ACP / Claude CLI 协议层	—	`packages/acp-core/`	REUSE
Agent 模板注册	6 个新模板	`system/templates/_registry.json`	NEW
三层 Loop 编排	`LoopController`	`server/src/core/loop-controller.js`	NEW
PRD/SDD 文档存储	`DocStore`	`server/services/doc-store.js`	NEW
Unit 状态机	`UnitRegistry`	`server/services/unit-registry.js`	NEW
HTTP / SSE 入口	`/api/devloop/*`	`server/routes/devloop.js` → 挂在 `server/index.js`	NEW
Web 看板	`DevLoopDashboard.vue`	放在 `web/src/views/`，复用 `PipelineEditor` DAG 渲染	NEW
结果持久化根	—	`data/companies/{cid}/projects/{pid}/`	REUSE · 沿用 company-scoped 文件根
进程沙箱 / 端口管理	—	`server/src/engine/process-guard.js`	REUSE
WS 流式	—	`server/routes/claude-chat-ws.js`	REUSE · DevLoop SSE 走 HTTP 复用同套帧

分层视图

三色块代表三种改动类型；越靠下越基础，越靠上越业务。

红新增 · 灰复用 · 黄补丁 · 黑底层依赖

为什么 P1~P4 不抽公共 retry 函数

EvolutionLoop 当前实现 PRAE (Perceive → Reason & Plan → Execute → Evaluate → Reflect)，里面有「失败 → 反思 → 重试」逻辑。直觉上 L1 可以共用，但初版决定不抽：

避免回归风险：EvolutionLoop 跑的是 Skill 进化，目前在生产里运行。动它意味着要把 Skill 进化的回归一起做。
反思 prompt 差异大：Skill 进化的反思是「Skill 评分低，怎么改 prompt」；L1 的反思是「单测失败，代码哪里错」。共用会让 prompt 模板变成「上帝模板」，反而难维护。
80 行不算多：P2 在 loop-controller.js 内重写一份 retryWithReflection 也就 80 行，DRY 不必这么早追。

// P2 直接在 server/src/core/loop-controller.js 写一份新的
async function retryWithReflection(unit, budget) {
  let failures = [];
  for (let i = 0; i < budget; i++) {
    await agentManager.callAgent('coder', { spec: unit.spec, history: failures });
    const r = await agentManager.callAgent('tester', { unit });
    if (r.ok) return { ok: true, retries: i };
    failures.push(r.failures);
  }
  return { ok: false, reason: "budget_exceeded" };
}
// P5 视实测情况再决定是否与 evolution-loop 合并到 packages/ 公共目录

这条改动同步影响 plan-migration.html 的 P2 阶段：retry 函数从「抽公共」改为「直接新写」。

不动的边界

本次改造绝不触碰：

ACP 协议本身（packages/acp-core/）
Master / Orchestrator 已有行为（仅注册新的 6 个 Agent 模板）
WebSocket 路由（/ws/claude）
SkillsMarket / Arena 路径下任何文件
认证 / 用户系统（routes/auth.js, routes/users.js）