SuperAPI AI 工具集

to-prd

写作与研究

查看项目

更新于 10-16 03:37

技能介绍

用途:to-prd 接收状态为 ready-for-prd 的决策记录,产出可评审的产品需求文档(PRD),经用户明确批准后作为 to-tasks 的唯一输入。适用于 interview-me 或已收敛的产品讨论之后。

主要能力:读取 .ai-workflow/work/<feature-slug>/decision-record.md,复用其中稳定的决策 ID 与来源索引(含权威性、定位符、内容修订),保留已定选择;先写出状态为 draft 的 .ai-workflow/work/<feature-slug>/prd.md,用户接受后改为 approved。PRD 以 # PRD: <feature name> 与 Status: draft 开头,包含问题与目标、用户故事或旅程、可观察的验收结果(含重要失败行为)、已定的产品/领域/集成/数据决策、安全决策(或“无暴露的安全面”)、发布与回滚约束、范围外事项/假设/剩余风险,以及关联决策记录的决策 ID。

使用方式:确认决策记录状态为 ready-for-prd 后开始起草;由协调者单独起草,不选模型、不解析路由、不派发 worker。可直接调用时先用 shared/references/model-preview.md 选择分支;实际 worker 分支使用一份已批准的路由快照,嵌套调用复用该快照。用 shared/references/workflow-measurement.md 记录特性度量与采集 API,保留各阶段执行台账与不可变计划,在起草前采集 stage-start,在请求与响应处采集实际批准等待,批准后采集 stage-end。通过 shared/references/answer-evidence.md 记录实际接受或纠正并复用其来源 ID。

限制:PRD 停留在决策层面,不开启新的架构选择,不规定文件、代码、设计模式或测试机制。缺少关键决策或出现来源冲突时退回 interview-me,并说明具体问题、冲突证据与来源定位符,不得凭猜测生成可批准 PRD。仅当记录缺少定位符或修订,或事实已变更、有争议时才复查原始来源。静默不等于批准。批准后的 PRD 是 to-tasks 接受的唯一输入,下一步为 to-tasks。