module-designer

Module Designer

Overview

把"模块设计"和"idea 拆分"合并到一次对话里完成。读设计输入（brainstorming / figma / 访谈）→ 与用户在对话收敛模块边界 → 自动拆分为 N 条 backlog idea（每条自动建议 type）→ 生成 module 文档 + 写入 backlog → 全量重渲染 roadmap。

职责边界： 只负责 L0→L1→L2 的设计层工作。PRD 生成由 prd-writer，技术规划由 change-propose，执行/审查由 change-dispatch / change-review。

Announce at start: "Running module-designer: designing module and decomposing into backlog."

When to Use

• 用户说"帮我设计一个 XX 模块" / "帮我把这个想法拆一下"
• 用户触发 /design "<主题>"（新建模块）
• 用户触发 /design M-NNN（对已有模块增量更新）
• 用户触发 /design review M-NNN（复盘重排，允许较大幅度修改）
• 有新的 design/inputs/** 素材需要转化为模块+idea

Bash 命令规范

1. 每条命令独立调用 — 不用 &&、||、; 串联
2. 管道可以用 — 如 git log | head
3. 并行无依赖时分开调用 — 多个独立 Bash tool call

输出物清单

单次运行产出（通过 governance/module-designer/M-NNN-RNNN PR 合入 main；RNNN 为该模块下一治理修订号）：

1. design/modules/M-NNN-<slug>.md（新建或增量更新）
2. product/backlog.md（新增 N 行 idea，含"模块"列 + 自动建议的 type）
3. design/roadmap.md 的 3 段 AUTO 区（ARCHITECTURE + DEPENDENCIES + PROGRESS）
4. .logs/module-designer/M-NNN.md 复盘日志

---

Phase 0 — 同步远程

在读任何文件之前，先同步远程状态：

git checkout main
git pull --ff-only origin main

目的：

• 保证 M-NNN / B-NNN 编号分配不冲突
• 保证读到最新的 backlog 和 roadmap
• 保证不在过时基线上设计

失败处理： 冲突时提示用户先解决再继续。

---

Phase 1 — 输入定位

根据触发参数分派：

触发	动作
/design "<主题>"	新建模式：分配下一个 M-NNN，等 Phase 2 对话收敛 slug
/design M-NNN	增量模式：读 design/modules/M-NNN-*.md 现状
/design review M-NNN	复盘模式：允许修改已有模块边界/依赖；禁止改已归档 backlog

M-NNN 分配（全局递增）

ls design/modules/ | grep -oE 'M-[0-9]+' | sort -Vu | tail -1

取最大值 +1；无已有模块时从 M-001 起。

治理修订号（防止增量模式被永久 checkpoint 卡住）

新模块使用 R001。已有模块按 ## 修订历史 的有效记录数 +1 得到 RNNN；同一 main 快照上的并发会话会得到同一 revision scope，只有一个 governance PR 能进入，其余返回 PENDING，待先到者合并后重新同步并计算下一 revision。scope 一次只代表一次状态转换，不能永久复用裸 M-NNN。

B-NNN 预分配（全局递增）

在 Phase 3 对话确定要拆几条 idea 后，按顺序从当前 backlog 最大 B-NNN 之后预留：

grep -oE 'B-[0-9]+' product/backlog.md | sort -Vu | tail -1

若无输出则从 B-001 起。初始化模板不得包含真实 B-NNN 占位编号，避免污染首次分配。