project-specification

项目简介转可测试规格说明书

文档写作 产品经理项目经理 生成项目需求文档 通用 ★ 1.1k 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:project-specification。
它的用途是:项目简介转可测试规格说明书
完整的 Skill 内容见:https://321skill.com/skills/project-specification-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请将以下项目简介转化为可测试的规格说明,包含用户故事和验收标准:我们想要开发一个在线购物车功能,允许用户添加商品、修改数量、删除商品,并在结账时计算总价。' 它会输出用户故事如“作为用户,我想修改购物车中商品的数量,以便调整购买数量”,并附上验收标准如“Given用户已添加商品到购物车,当用户修改数量为0时,系统应将该商品从购物车中移除”。

介绍

解决什么问题:在项目启动初期,团队往往只有模糊的简介或想法,缺乏可执行、可验证的规格说明。本 Skill 能将项目简介转化为结构化的、可测试的规格文档,包含用户故事和验收标准,帮助团队在头脑风暴后、规划前对齐需求,避免后续开发中的理解偏差和返工。

怎么用:将项目简介(如“开发一个在线购物车功能”)作为输入,Skill 会自动生成包含多个用户故事(如“作为用户,我想将商品添加到购物车,以便后续结账”)和对应的验收标准(如“给定用户已登录,当点击‘加入购物车’按钮时,系统应将商品添加到购物车并显示数量”)的完整规格文档。输出格式清晰,可直接用于开发任务拆解和测试用例设计。

适合谁:产品经理需要将模糊需求落地为可执行文档;项目经理需要为团队提供明确的范围和验收条件;开发人员和测试人员需要可验证的输入输出,确保代码实现符合预期。

使用建议:在头脑风暴结束、正式规划开始前使用效果最佳。输入应包含核心功能目标和关键约束,避免过于抽象或过于细节。生成后建议与团队评审,确保用户故事和验收标准覆盖所有关键路径。

核心特点

与其他需求文档生成工具相比,本 Skill 强制输出可测试的验收标准,直接关联用户故事,并遵循“Given-When-Then”格式,能无缝衔接测试驱动开发(TDD)流程。

注意事项

不适合需要大量创意发散或非结构化输出的场景,也不适用于已有详细设计文档的项目。

常见问题

怎样确保生成的验收标准是可测试的?

Skill 内置了可测试性规则,自动生成具体的、可验证的 Given-When-Then 条件,避免模糊描述。您也可以手动调整,确保每个验收标准有明确的输入、操作和预期结果。

输入的项目简介需要多详细?

建议包含功能名称、用户角色、核心操作流程和关键约束(如权限、数据格式)。一两句话即可,无需完整 PRD,Skill 会自动补充细节。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/project-specification-x-5/raw/index.md 读取 project-specification 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。