SuperAPI AI 工具集

3-prd

写作与研究

查看项目

更新于 10-15 14:40

技能介绍

用途

3-prd 是 Devpost Learn 学习路径中的第三个技能,承接已批准的 scope.md,把范围草图变成一份具体、可执行的产品定义文档(PRD)。它的核心目标是:在写代码之前,把“这个产品到底做什么”讲清楚——包括核心用户旅程、每个具体行为、界面状态与边界情况,以及一个明确的概念验证(POC)边界。

该技能明确不涉及代码、技术栈或架构,只聚焦于产品行为本身。

主要能力

  • 进度检查与路由:读取项目 devpost/ 目录下的 learner-profile.md、scope.md、prd.md、spec.md、checklist.md,根据各文件 frontmatter 中的 status 判断当前进度,并决定是开始新 PRD、继续草稿、还是指向下一步 4-spec。
  • 以学习者为主导的产品访谈:默认一次问一个开放式问题,不使用选择题工具;根据学习者的编程经验和沟通偏好调整问题深度与节奏。
  • 重建核心旅程:引用 scope.md 中的实际标题作为提问锚点,逐步走完核心循环,直到能像在屏幕上演示一样把流程演出来。
  • 命名行为:把浮现出的行为组织在清晰稳定的标题下,供后续 4-spec 和 5-build 引用。
  • 定义可检验的验收标准:针对每个行为,从学习者已描述的内容中提炼出可在构建时通过查看屏幕来检验的标准。
  • 处理边界情况:只针对首次使用、明显错误、无内容可显示等少数关键边界情况提问,不要求穷举测试矩阵。
  • 守护 POC 边界:当需求超出 2–4 小时活跃工作和一次演示所能承载的范围时,明确指出并帮助区分“现在构建”与“推迟”。
  • 生成文档:将访谈结果填入 prd-template.md,保存为 devpost/prd.md,初始 status: draft;学习者明确批准后设为 status: approved。
  • 可选 HTML 审阅版:若学习者偏好 HTML 审阅格式,可生成 devpost/prd.html,包含旅程图(Mermaid 或内联 SVG)以及各屏幕行为、空/错误状态和验收标准的分步展示。Markdown 始终是权威版本。

使用方式

该技能以对话形式运行。开始前会读取 devpost/scope.md 和 devpost/learner-profile.md,了解范围、经验水平、规划工作流经验、协作与沟通偏好、期望学习成果和审阅格式。

访谈通常围绕以下环节展开:

  1. 重建核心旅程:从用户打开产品看到什么开始,逐步走完整个核心循环。
  2. 设计方向(1–2 个问题,非独立访谈):针对视觉项目,简要询问字体、颜色、风格或参考,避免构建时落入通用 AI 应用样式;CLI 或非视觉工具则只关注输出可读性或语气。
  3. 命名行为:把行为整理到稳定标题下,并回放确认。
  4. 如何知道它有效:为每个行为提炼可检验的验收标准。
  5. 如果……会怎样:处理少数关键边界情况。
  6. 守护边界:识别范围膨胀,区分现在构建与推迟。

当核心旅程、具体行为、可检验验收标准和关键空/错误状态都清晰后,即可起草文档供审阅。通常约四到五次有意义的交流后,会询问学习者是想继续探索还是直接写草稿。

适用场景

  • 已完成 2-scope 且 scope.md 状态为 approved,准备进入产品定义阶段的学习者。
  • 需要把模糊的产品想法转化为具体、可演示的 POC 定义的项目。
  • 希望练习“先规划再构建”这一决策能力的学习者。
  • 适合小型概念验证项目,而非完整产品规划。

限制

  • 不涉及代码、技术栈或架构;相关问题会被引导到 4-spec。
  • 不替学习者做产品决策,AI 只负责组织和澄清学习者的回答。
  • 不编造学习者的意图;未解决的假设会被明确标注。
  • 文档完整性优先于长度,小型产品对应短 PRD 是正确的。
  • 若 scope.md 缺失或未批准,会要求先完成 2-scope 并停止。
  • 若 prd.md 已批准,会指向 4-spec 并停止,除非学习者想重新打开。
  • 不使用选择题工具,始终自由回答。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。