paw-ps-research-to-brief

研究转产品简报

概述

一个确定性工作流，可将经过验证的研究成果转换为清晰、结构化的产品简报。此流水线可确保在综合过程中不遗漏任何证据或不确定性。

参数： 支持通过 --headless / -H 进行非交互式执行。

输出： 保留信号（证据和不确定性）的产品简报文档。

---

流水线

阶段 1：收集输入

加载 ./references/01-gather-inputs.md

从产品工作区收集所有相关研究文件：

• 探索输出（product-context.md）
• 市场情报（market-intelligence.md）
• 受众情报（audience-intelligence.md）

推进条件： 找到至少一个输入源后继续。

阶段 2：验证完整性

加载 ./references/02-validate-completeness.md

评估输入是否达到简报综合的最低要求。识别缺口，并根据现有数据继续，或标记需要补充研究。

推进条件： 达到最低输入要求，或已明确决定在记录缺口的情况下继续。

阶段 3：综合简报

加载 ./references/03-synthesize-brief.md

通过整合经过验证的输入，创建结构化产品简报。应用一致的格式，并确保内容可追溯至源材料。

推进条件： 简报结构完整，所有必需章节均已填写。

阶段 4：保留信号

加载 ./references/04-preserve-signals.md

记录关键证据来源和未解决的不确定性。创建信号保留说明，将决策追溯至研究发现。

推进条件： 所有信号均已记录，并附加到简报或决策日志中。

---

激活时

1. 确定产品工作区根目录：{project-root}/.pawbytes/prodig-suites/
2. 如果 .pawbytes/prodig-suites/active-product.md 存在，则识别当前活动的产品上下文
3. 如果未设置活动产品且不处于无头模式，则提示用户指定产品 slug
4. 从阶段 1 开始执行流水线

---

输入来源

来源	文件路径	必需
探索	.pawbytes/prodig-suites/products/{product-slug}/product-context.md	首选
市场研究	.pawbytes/prodig-suites/products/{product-slug}/market-intelligence.md	首选
受众研究	.pawbytes/prodig-suites/products/{product-slug}/audience-intelligence.md	首选

最低要求： 三个输入源中至少有一个可用。

---

输出结构

.pawbytes/prodig-suites/products/{product-slug}/
├── product-brief.md              # Main brief document
├── signal-notes.md               # Evidence and uncertainty log
└── product-decisions.md          # Appended brief metadata (if exists)

---

输出约定

每次执行都会交付：

• 操作类型： 根据研究输入综合简报
• 保存的文件：
  • product-brief.md — 结构化产品简报
  • signal-notes.md — 证据和不确定性保留记录
• 建议： 后续步骤（例如，与利益相关者验证、启动设计阶段）
• 文件保存至： .pawbytes/prodig-suites/products/{product-slug}/

---

无头模式

使用 --headless 或 -H 调用时：

1. 尝试从 .pawbytes/prodig-suites/active-product.md 读取活动产品
2. 如果未找到，则扫描最近修改的产品工作区
3. 无需提示，执行所有阶段
4. 在信号说明中记录任何缺口或假设
5. 成功时以状态码 0 退出；未达到最低输入要求时以状态码 1 退出

---

质量门槛

阶段	门槛条件
收集输入	找到至少 1 个输入文件
验证完整性	达到最低输入门槛，或已记录继续执行的决定
综合简报	所有必需的简报章节均已填写
保留信号	所有证据和不确定性均已记录