SuperAPI AI 工具集

product-definition-builder

办公与效率

查看项目

更新于 10-16 14:14

技能介绍

Product Definition Builder 是 phlegonlabs/product-delivery-harness 中的一项技能,用于创建或完善经所有者批准的产品定义包,目标是把产品想法转化为“可决策”的交付物,而不是让代理自行猜测实现方案。

用途 该技能用于定义产品范围、用户旅程、UI 界面职责、路由、操作、状态、数据、信任与安全边界、验收信号、实现架构、发布目标和技术约束。它会起草并协调 PRD.md、architecture.md 与 stack-decisions.md,并提出前端、后端/数据/鉴权、移动/桌面、AI、部署和商业化等技术选项,随后获取明确的 Stack Decision Checkpoint 和 Product Definition Approval。

主要能力

  • 初始产品定义:从用户需求出发,形成完整的决策就绪产品定义包。
  • 增强模式:对已接受的增强交付,保留当前 PRD 和既有 ID,复用已做出的决策,避免对同范围实现修复重复审批。若产品决策确实发生变化,则视为下一轮契约缺口,而不是伪造审批的依据。
  • UI 增强交接:交接新增或变更的 UI ID,以及必要的进入或返回路径,并显式保留其他所有界面;下游按 ui-design-builder 的 Incremental UI Scope 处理,不要求重新做全屏设计包,也不重置未受影响的审批。
  • 测试画像定义:在审批前定义测试画像(角色、租户、账号/数据状态)、适用的 Web/原生/代理旅程、可观察的成功与拒绝/无副作用断言,以及 mock 与真实沙箱义务,并记录在现有 TEST 行和架构测试章节中;不适用时记录“不适用”,而不是为无头或未鉴权产品虚构登录。

使用方式 安装后的命令需将 <product-definition-builder-skill-root> 解析为包含已安装 SKILL.md 的绝对目录;同级 skill 根目录通常位于 ~/.agents/skills/。脚本路径需加引号,工作目录与 --repo-root 保持在目标项目,且不得假设项目包含 skills/。在 references 中,skills/<name>/scripts/、<name>/scripts/ 和裸 scripts/ 均为逻辑安装路径,执行前需展开为观察到的绝对技能根目录。仓库维护与 CI 命令仍从本源仓库运行。每次调用时应用 ../delivery-harness/references/document-sync-contract.md。

阶段路由

  • 定义或增强开始前:阅读 Workflow、Interview Rules 和 Output Standards;增强模式先使用其限定范围的增量分支,不强制初始访谈。
  • 请求 Product Definition Approval 前:阅读 Self-Review Before Product Definition Approval。
  • 准备 UI 交接前:阅读 Current UI Preflight。
  • 解决适用领域决策前:阅读 Reference Routing。
  • 实际初始起草:遵循 Workflow 中的完整必需流程。

适用场景 适用于需要把产品想法整理为可审批定义包的场景,以及在不改变既有产品决策前提下的增强交付场景。对于 UI 增强,可衔接后续 UI 设计;对于实现请求,可衔接 delivery-harness 使用已批准输入。

限制 PRD.md 和 architecture.md 仍是规范的英文实现来源,中文评审副本仍为必需。Product Definition Approval 和 Stack Decision Checkpoint 是明确的所有者关口。该技能不启动 UI 设计、实现、PLAN/RUN 或 E2E 证据登记。完成的定义包不会自动启动下游工作。在 Product 检查点应用 Generate、Verify And Correct:作者修复已接受范围的缺陷并重跑聚焦检查,所有者提供人工批准与契约变更。