SuperAPI AI 工具集

ln-12-product-requirements-builder

写作与研究

查看项目

更新于 10-16 09:21

技能介绍

Product Requirements Builder 是一个面向产品需求文档编写的技能,目标是为已确认的意图创建或更新可用的产品需求产物,保留所有者意图并使预期行为可测试。它只修改被授权的产品文档,不虚构承诺、不设计架构、不实现功能。

用途: 该技能用于把已提交的意图转化为结构化的产品需求,包括业务规则、验收标准与可观察行为。它强调区分观察到的行为、所有者偏好、提议需求、已接受承诺与未决选择,并保留来源需求与决策 ID。

主要能力:

  • 建立意图与权限:解析问题、受影响角色、预期结果、时间范围、已批准文档范围与受保护的现有体验;读取仓库说明、相关用户证据与现有需求;识别唯一权威需求目的地与决策所有者。
  • 描述可观察行为:为每个范围内旅程描述触发事件、角色权限、前置条件、成功结果与有意义的替代路径;规定业务规则、计算、实体与生命周期转换;规定失败、空、加载、重试、重复、取消与恢复行为;记录集成、外部承诺、兼容性与数据约束;捕获无障碍、隐私等用户面向约束。
  • 定义验收与结果:为每个重要需求给出可观察的验收条件,包含前置条件与独立于实现的预期结果;定义预期业务效果、可用基线、测量窗口与证据来源;识别可能反转范围、验收或产品方向的依赖与假设。
  • 写入与校验:以需求 ID、来源/状态、验收、非目标、假设与未决决策写入已批准产物;保留无关内容与已变更承诺的历史,标记取代而非静默替换已接受意图;检查规则、场景与验收之间的一致性。

使用方式: 该技能以清单驱动执行,逐项内部跟踪为 PENDING、PROVEN、CLEARED 或 UNPROVEN,只有观察到的结果才算证据。每个部分后对账,返回前解决所有 PENDING,只统计 PROVEN 与 CLEARED,并对每个缺口应用判定与批准规则。它优先复用现有需求所有者,否则使用被授权的 docs/product/requirements.md,不向既有项目强加新的文档层级。当运行期间无人可回答时,说明确切问题并应用该技能对剩余缺口的判定,而不是等待或猜测。

适用场景: 适用于需要为已确认意图编写或更新产品需求文档、业务规则与验收标准的场景,尤其是需要保留来源需求与决策 ID、区分功能验收与产品影响、并明确未决决策与假设的场合。

限制: 该技能只编辑被授权的产品文档,不设计架构、不实现代码、不虚构承诺。它不要求其他技能、命名产物或完整生命周期。若范围、权限、必要意图或安全目的地缺失,则判定为 BLOCKED。判定 READY 表示需求一致且可测试,不表示所有者已接受。输出按用户语言报告,包含 Result、Scope、Evidence、Verification、Completion 五个字段。