用途:当用户要求撰写 PRD、定义需求或规划功能时,生成以问题为先的产品需求文档,包含可衡量的成功指标、可测试的验收标准与清晰的范围边界。每个 PRD 都从用户问题出发,而非从解决方案出发。
主要能力:读取产品上下文(扫描 .chalk/docs/product/ 中的产品档案 0_product_profile.md、JTBD 文档、已有 PRD 和用户研究,并检查 .chalk/docs/engineering/ 中的架构文档以评估可行性);解析 $ARGUMENTS 识别问题空间、目标用户与约束,若过于模糊则先进行一轮澄清提问;确定下一个文件编号(读取 .chalk/docs/product/ 中最大编号加一);生成包含全部必填章节的 PRD;交叉引用架构验证方案在当前技术栈中的可行性,并在依赖章节标记新增基础设施、服务或第三方依赖;将无文档或用户输入支撑的陈述列入开放问题;写入文件并确认,提示最需解决的 2-3 个开放问题。
PRD 结构:问题陈述、目标用户(含反用户)、成功指标(可衡量、有时限、有基线)、用户故事(按活动分组,含 Given/When/Then 验收标准)、功能级验收标准、边界情况(错误、空状态、边界条件、权限、向后兼容)、范围外、依赖(内部/外部/技术)、开放问题(编号并注明负责人)。
输出:文件保存至 .chalk/docs/product/<n>prd<slug>.md,纯 markdown,无 YAML frontmatter,首行为 # PRD: <Feature Name>,第二行为 Last updated: <YYYY-MM-DD> (Initial draft)。
限制与反模式:避免方案先行、缺少成功指标、遗漏范围外章节、验收标准含糊、以功能列表代替用户成果、留空模板、忽略已有产品上下文。若某章节确实无信息,应移入开放问题并说明缺失内容。