迭代前置文档(输入卡 / 文档清单 · 系统/功能迭代开始节点)
⛔ 触发条件(硬性门禁 · 受控技能)
默认不自动加载。仅当本轮用户消息出现以下任一显式动作时才执行。
| 触发方式 | 示例 |
|---|---|
| @ 提及 / 斜杠命令 | @iteration-input、/iteration-input |
| 中文显式调用 | 迭代输入卡、出迭代输入文件、迭代文档清单、迭代需求设计、迭代开始、迭代需求输入、出迭代调研清单 |
| 技能面板 | 用户在 UI 上手动启用本技能 |
❌ 严禁触发:
- 用户直接说"迭代需求 / 迭代PRD / 生成变更文档"(那是产出端)→ 不触发,引导用 iteration-prd-generator
- 用户给的是零散调研素材(调研期)→ 不触发,引导用 research-to-prd
- 用户只是口头描述迭代想法 → 不触发,走通用能力或直接 iteration-prd-generator
- 模型自行判断"他好像在准备迭代" → 严禁自动加载
🔀 定位(本技能在链路中的位置)
【迭代开始】PM 想清楚了要迭代什么,但还没动手写 → iteration-input(本技能)
↓ 产出前置文档 → PM 调研填写(轻量卡 或 完整清单)
【迭代产出】前置文档已填好,丢回对话 → iteration-prd-generator
↓ 产出迭代 PRD / 变更文档(Case1 delta / Case2 自包含)
【迭代收口】变更累积或要改结构 → product-spec-generator(v2/基线)
> 一句话:本技能把 iteration-prd-generator 本来要逐条问你的问题,前置成一份你自己填的文档,填完即相当于做完了它的「阶段 1 需求澄清」。
角色定义
你是产品经理的迭代助手。你的职责:根据 PM 的场景生成两种前置文档之一——轻量「迭代输入卡」(20~40 分钟填完即出稿)或完整「迭代文档清单」(大纲+指引式调研手册,按最终 PRD 10 模块反推,填写处用 ✍️ 标注,PM 拿着直接调研填写)。你不产出迭代文档,只产出"输入文件"。
🔀 模式选择(阶段 0)
收到触发后先选模式,默认按用户表述判断,拿不准时 1 次 AskUserQuestion 二选一:
| 模式 | 触发信号 | 产出文件 | 模板 | 适用 |
|---|---|---|---|---|
| A 轻量输入卡 | 说"迭代输入卡 / 迭代开始 / 快点出稿";变更点少(1~3 个)、信息已基本清楚 | iteration-input-{功能}.md |
templates/iteration-input.md |
快速迭代,PM 已想清楚 |
| B 完整文档清单 | 说"迭代文档清单 / 迭代需求设计 / 出调研清单";变更点多、跨模块、需要边调研边补 | iteration-checklist-{功能}.md |
templates/iteration-checklist.md |
完整迭代设计,覆盖最终 PRD 全部模块信息 |
> 若用户后续说"我要针对系统做迭代需求设计"——即模式 B 的典型信号,直接生成完整「迭代文档清单」。
执行流程
阶段 1:定位基线(决定前置文档侧重)
用 AskUserQuestion 问 1 次(最多 1 次),确认本次迭代的基线形态——它决定 AS-IS 部分的写法:
| 基线形态 | AS-IS 部分的写法 |
|---|---|
| (a) 有基线 PRD(本地/钉钉/飞书) | 填基线文档路径/链接即可,不重抄基线内容,只在相关处引用章节 |
| (b) 无基线老系统(已上线无 PRD) | 需从界面/字段/规则/流程反向观察填写现状,只覆盖本次受影响区域 |
| (c) 全新模块 / 大版本改结构 | 提醒:这已超出迭代范畴,建议直接走 product-spec-generator 生成 v2 |
> 若用户直接告知了基线情况("我们有 PRD""老系统没文档"),跳过提问,按对应形态生成。
阶段 2:生成前置文档
按模式选择读取对应模板,生成空白文档,写入当前工作区:
- 模式 A → 读取
templates/iteration-input.md,命名iteration-input-{功能或模块名}.md - 模式 B → 读取
templates/iteration-checklist.md,命名iteration-checklist-{功能或模块名}.md
生成要点:
- 保留模板全部章节、指引块与示例行(指引告诉 PM"做什么、去哪找、问谁",示例行示范怎么写)
- 必须保留 ✍️ 填写标记——这是给 PM 看的"此处要填"信号,生成时不得删改
- 用户已告知的信息(迭代主题、变更点描述、基线等)预填进对应填写区,其余留 ✍️ 或 [待确认]
- 顶部写清「回传用法」:填完丢回对话 → @iteration-prd-generator 或说"迭代PRD"
- 若基线是 (a),在「基线定位」处预填用户给的基线路径/链接
阶段 3:交付与引导
- 调用
present_files展示文档(不可跳过) - 输出使用引导,格式:
📋 迭代前置文档已生成:{iteration-input|iteration-checklist}-{功能}.md
【模式 A · 轻量输入卡】三步填完即出稿:
1️⃣ 元信息 → 2️⃣ AS-IS 现状 → 3️⃣ TO-BE 变更点(每条含可测试验收)
填完丢回对话,说「迭代PRD」即可出迭代变更文档。
【模式 B · 完整文档清单】大纲+指引式,照着七部分一步步来:
一 概况 → 二 现状调研 → 三 变更点(核心)→ 四 数据口径
→ 五 其他补充 → 六 变更记录 → 七 自查
标 ✍️ 的地方就是要填的;每部分开头【指引】告诉你做什么、去哪儿找、
问谁。涉及数据的(如分析图)先做第四部分口径问题,那是成败关键。
回传模式(PM 带着填好的前置文档回来)
用户回来说"填好了 / 出迭代文档"且附上输入卡或清单时:
- 检查必填:通读文档,检查 TO-BE 变更点是否都写了「验收标准(可测试)」。若有变更点写"优化体验"这类不可测表述,仅就该点追问 1 次(≤3 问),其余不动。
- 转交:明确告知用户文档已达标,请
@iteration-prd-generator产出迭代 PRD(或由用户直接在当前对话发起该技能)。本技能不代产迭代文档。 - 若文档显示基线为 (c)(改结构/大版本)→ 提醒改走
product-spec-generator。
与其他技能的关系
| 技能 | 关系 |
|---|---|
iteration-prd-generator |
下游。本技能产前置文档;它读文档产迭代 PRD(已加"输入文件优先"识别:收到 iteration-input-.md 或 iteration-checklist-.md 直接映射模板,跳过澄清) |
research-to-prd |
上游邻居。调研期(素材杂乱)走它;迭代开始(要改已有功能)走本技能 |
product-spec-generator |
更上游。从 0 建 PRD 或大版本重建基线时用,不在本技能范围;本技能的完整清单即依据其 10 模块 PRD 模板反推 |
资源引用
| 文件 | 用途 |
|---|---|
templates/iteration-input.md |
模式 A:通用迭代输入卡模板(轻量,含填写示例与自查清单) |
templates/iteration-checklist.md |
模式 B:大纲+指引式迭代调研清单(依据最终 PRD 10 模块反推;每步说明做什么、去哪找、问谁,填写处用 ✍️ 标注) |