SuperAPI AI 工具集

using-user-stories

编程与开发

查看项目

更新于 10-15 16:49

技能介绍

用途:以用户故事(user story)形式记录功能应做什么,并跟踪其实现状态。当 AI 代理按用户故事系统化推进时,输出质量更好,也留下清晰的工作痕迹。

工作流:1)编写/更新:在开发前创建或修改用户故事;2)构建与测试:持续实现直到测试通过;3)标记通过:验证后把 passes 设为 true。

何时创建用户故事:开始新功能或新流程;修复本应有测试覆盖的缺陷;实现设计或规格中的需求;把大功能拆成可测试的小增量。

编写有效步骤:步骤应可验证(每步都能通过运行应用或测试检查)、使用祈使句式(如 Navigate to、Click、Verify)、具体(包含 URL、按钮名称、期望值)。示例结构包含 description、steps 数组和 passes 字段;避免“删除聊天”“检查是否生效”这类模糊步骤。

记录已完成工作:完成功能后手动或通过测试验证所有步骤,把用户故事中 passes 更新为 true,并同时提交实现与更新后的故事,形成后续代理可参考的完成记录。

与 AI 代理配合:代理可读取用户故事以了解需要构建的功能、明确验收标准、找出仍需处理的功能(passes: false),并通过标记通过来记录进度;自动化代理循环可参考 Ralph Agent Loop 配方。

验证:运行验证脚本检查所有故事格式是否有效:bun run user-stories:verify,它会校验所有文件是否为合法 JSON、每个功能是否含有必填字段、步骤是否为非空字符串,并显示每个文件的通过/失败计数。

限制:资料未说明该技能支持的平台、安装方式、价格及除上述脚本外的具体实现细节,暂未提供。