SuperAPI AI 工具集

escribir-hus

写作与研究

查看项目

更新于 10-21 00:59

技能介绍

用途: 将一份 PRD 翻译为可执行的用户故事(HU),使开发者或智能体无需猜测 PRD 未说明的内容即可开始构建。该技能不限定项目领域(健康、金融科技、零售等均可),且不默认假设任何领域背景。

输入: 需要一份包含五个部分的 PRD,格式固定而领域可变:问题、目标、范围(包含/不包含)、假设与开放问题、成功标准。如果系统已有上下文,还会参考 docs/contexto/GLOSARIO.md 和 docs/contexto/CAPACIDADES.md,使 HU 使用术语表中的用语,并避免重复系统已有的能力。若 PRD 缺少某部分,技能会在不改变流程的前提下适配(例如从“问题”中提取目标),并明确说明这一点。

主要能力与工作方式:

  • 在动笔前完整阅读五个部分,以范围界定边界、以开放问题标记尚未决定的内容。
  • 将范围中每项清晰功能转为一条 HU,既不过度合并为巨型 HU,也不把同一动作的子步骤人为拆碎。
  • 在解决前先检测各章节之间的冲突;如范围、目标与成功标准不一致,不静默决定,而是记录冲突,仅构建满足标准所需的最小内容,并明确标注尚待业务确认。
  • 使用 assets/hu-template.md 撰写每条 HU:“作为/我想要/以便”式故事加至少两个 Gherkin 场景(正常路径加一个边界情况)。
  • 跨功能的业务规则(例如适用于多项功能的成功标准)作为边界场景在各受影响 HU 内验证,而不是单独成一条 HU。
  • 不因便利而假设 PRD 未确认的数据,而是将其声明为开放点,并附上向业务方提出的确切问题。
  • 不添加任何标记为“不包含”的内容,即使看起来是显而易见的改进。
  • 开放点只分配到字面适用的 HU 中,不默认复制到所有 HU。
  • 每条 HU 输出为一个 Markdown 文件,保存在项目文件夹中。

质量检查: 技能附带一份质量门清单,要求确认已读全部五个部分、每条 HU 对应范围中的清晰功能、每条 HU 至少两个 Gherkin 场景、无被假设数据写成已决定、无“不包含”项混入、每个开放点带确切业务问题、冲突已记录而非静默解决、已使用术语表且未重复已有能力、每条 HU 为一个 Markdown 文件。

参考文件: assets/hu-template.md 为 HU 模板;references/ejemplos-aplicados.md 收录以往项目中的已解决案例(范围冲突、开放点、其他智能体提出的范围外元素)。

适用场景与限制: 适用于已有结构化 PRD、需要产出可构建用户故事的开发前期环节。使用前提是 PRD 具备上述五部分结构(或可适配),且需要人工确认开放点与冲突。关于具体收费、平台支持、执行环境等信息,资料中暂未提供。