mb-from-prd

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

mb-from-prd — PRD → Memory Bank (greenfield)

mb-from-prd — PRD → 记忆库(全新项目)

  • What it does: converts a PRD into structured project knowledge and traceable planning artifacts.
  • Use it when: the project is greenfield and
    prd.md
    or equivalent requirements already exist.
  • Input:
    prd.md
    or user-provided PRD text plus an initialized
    .memory-bank/
    .
  • Output: product brief, RTM, epics, features, and concept docs ready for
    /prd-to-tasks
    .
  • 功能: 将PRD转换为结构化的项目知识和可追溯的规划工件。
  • 适用场景: 项目为全新项目,且已存在
    prd.md
    或同等需求文档时使用。
  • 输入:
    prd.md
    或用户提供的PRD文本,以及已完成初始化的
    .memory-bank/
    目录。
  • 输出: 产品概要、RTM、Epic、Feature、概念文档,可直接用于
    /prd-to-tasks
    流程。

Preconditions

前置条件

  • You are in the repo root.
  • prd.md
    exists (or the user provides PRD text).
  • .memory-bank/
    exists. If not, run
    mb-init
    first (or create the skeleton manually).
  • 你当前处于代码仓库根目录。
  • 存在
    prd.md
    文件(或用户提供PRD文本)。
  • 存在
    .memory-bank/
    目录。如果不存在,请先运行
    mb-init
    (或手动创建目录骨架)。

Process

流程

1) Load and sanity-check PRD

1) 加载PRD并进行合理性检查

  1. Read
    prd.md
    .
  2. Identify missing information and contradictions.
  3. Start a task protocol folder:
    • .protocols/PRD-BOOTSTRAP/
    • plan.md
      (steps)
    • decision-log.md
      (Q/A and choices)
  1. 读取
    prd.md
  2. 识别缺失信息和矛盾内容。
  3. 创建任务协议目录:
    • .protocols/PRD-BOOTSTRAP/
    • plan.md
      (步骤说明)
    • decision-log.md
      (问答记录和决策内容)

2) Skills / tooling discovery (optional but recommended)

2) 技能/工具发现(可选但推荐)

If the PRD mentions “use skills / tools / CLIs”:
  • run
    /find-skills
    (project-installed first; marketplace second)
  • propose a minimal set of relevant skills to use (do not install without confirmation)
如果PRD中提到“使用技能/工具/CLI”:
  • 运行
    /find-skills
    (优先查找项目已安装的,其次查找市场中的)
  • 建议一组最小可用的相关技能(未经确认请勿安装)

3) Deep Questioning (rounds)

3) 深度提问(多轮)

Use
./references/shared-deep-questioning.md
.
  • Ask questions in rounds of 3–5.
  • After each round: summarize, update
    decision-log.md
    , and ask the next round.
  • If user is temporarily unavailable: record
    Open questions
    in
    decision-log.md
    and stop. Do not proceed by inventing facts.
If the target mode is full autonomous:
  • non-blocking gaps may be recorded as explicit
    Assumptions
  • blocking gaps (security/compliance/external contracts/data-loss risks) must halt the run
使用
./references/shared-deep-questioning.md
  • 每轮提出3-5个问题。
  • 每轮结束后:总结内容,更新
    decision-log.md
    ,然后提出下一轮问题。
  • 如果用户暂时无法回复:在
    decision-log.md
    中记录
    待解决问题
    停止流程,请勿自行编造信息继续推进。
如果目标模式为完全自治
  • 非阻塞性的信息缺口可记录为明确的
    假设条件
  • 阻塞性缺口(安全/合规/外部合约/数据丢失风险)必须终止运行

4) Write L1 Product brief

4) 编写L1级产品概要

Update
.memory-bank/product.md
(use the user’s wording).
更新
.memory-bank/product.md
(使用用户的原始表述)。

5) Requirements + RTM

5) 需求 + RTM

Update
.memory-bank/requirements.md
:
  • Enumerate REQ-IDs.
  • Define “out of scope”.
  • Fill RTM: REQ → Epic → Feature → Test.
更新
.memory-bank/requirements.md
  • 枚举REQ-ID。
  • 定义“超出范围”的内容。
  • 填充RTM:需求ID → Epic → Feature → 测试。

6) Create Epics (L2, draft-first)

6) 创建Epic(L2级,优先草稿)

For each epic:
  • Create
    .memory-bank/epics/EP-<NNN>-<slug>.md
  • Use
    references/epic-template.md
    .
  • Ensure business value + success metrics.
  • Default
    status: draft
    until open questions are resolved.
每个Epic对应:
  • 创建
    .memory-bank/epics/EP-<NNN>-<slug>.md
  • 使用
    references/epic-template.md
    模板。
  • 确保包含业务价值 + 成功指标。
  • 默认
    status: draft
    ,直到所有待解决问题都被处理。

7) Create Features (L3, draft-first)

7) 创建Feature(L3级,优先草稿)

For each feature:
  • Create
    .memory-bank/features/FT-<NNN>-<slug>.md
  • Use
    references/feature-template.md
    .
  • Ensure autonomy and explicit acceptance criteria.
  • Default
    status: draft
    until acceptance criteria + verification plan are solid.
每个Feature对应:
  • 创建
    .memory-bank/features/FT-<NNN>-<slug>.md
  • 使用
    references/feature-template.md
    模板。
  • 确保包含自治性和明确的验收标准。
  • 默认
    status: draft
    ,直到验收标准 + 验证计划都确认无误。

8) Tasks planning (per-feature, no “everything at once”)

8) 任务规划(按Feature拆分,避免“一次性完成所有”)

Do not generate a full-task backlog “в лоб” for all features in one pass.
Instead:
  1. Seed
    .memory-bank/tasks/backlog.md
    with a short structure (waves + placeholders).
  2. For each selected feature, run
    /prd-to-tasks FT-<NNN>
    to produce:
    • .memory-bank/tasks/plans/IMPL-FT-<NNN>.md
    • atomic
      TASK-*
      items grouped by waves
This keeps planning accurate and avoids speculative task explosions.
禁止一次性为所有Feature生成完整的任务待办列表。
正确做法:
  1. .memory-bank/tasks/backlog.md
    初始化简要结构(阶段 + 占位符)。
  2. 对每个选定的Feature,运行
    /prd-to-tasks FT-<NNN>
    生成:
    • .memory-bank/tasks/plans/IMPL-FT-<NNN>.md
    • 按阶段分组的原子化
      TASK-*
这种方式可以保证规划的准确性,避免产生大量推测性任务。

9) Duo docs for key concepts

9) 为核心概念创建双文档

For every concept that would otherwise require “reading many files” to understand later:
  • .memory-bank/architecture/<concept>.md
    (WHAT/WHY)
  • .memory-bank/guides/<concept>.md
    (HOW)
对于后续需要“阅读大量文件”才能理解的每个概念:
  • .memory-bank/architecture/<concept>.md
    (是什么/为什么)
  • .memory-bank/guides/<concept>.md
    (怎么用)

10) Update index

10) 更新索引

Update
.memory-bank/index.md
with annotated links to everything new.
.memory-bank/index.md
中添加所有新增内容的带注释链接。

11) Review gate

11) 评审关口

Run a fresh-context review (preferably
mb-review
).
运行一次新上下文评审(优先使用
mb-review
)。

12) Autonomous handoff (optional)

12) 自治交接(可选)

If the goal is “PRD → done without more user interaction”:
  • do not execute tasks from here manually
  • hand off to generated project command
    /autonomous
如果目标是“无需更多用户交互,从PRD到交付完成”:
  • 请勿从此处手动执行任务
  • 交接给生成的项目命令
    /autonomous

Definition of done

完成标准

  • product.md + requirements.md are coherent.
  • Every REQ maps to an Epic/Feature in RTM.
  • Epics and features exist with acceptance criteria.
  • backlog.md exists as a plan skeleton; feature-level tasks are produced via
    /prd-to-tasks
    .
  • index.md is updated.
  • product.md + requirements.md内容连贯一致。
  • 每个需求ID都在RTM中映射到对应的Epic/Feature。
  • Epic和Feature都已创建,且包含验收标准。
  • 存在作为规划骨架的backlog.md;Feature级任务通过
    /prd-to-tasks
    生成。
  • index.md已更新。