spec-writing
将模糊的功能描述转化为清晰、可测试的规格说明书
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：将模糊的功能描述转化为清晰、可测试的规格说明书 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我们需要为电商应用添加一个“心愿单”功能，用户可以把喜欢的商品收藏起来，以后方便查找和购买。’ 它会首先询问或确认关键细节，如用户身份、商品状态、分享权限等，然后生成包含多个用户故事（如“作为登录用户，我希望将商品加入心愿单，以便稍后购买”）及对应的详细验收条件（如“Given 用户已登录并浏览商品详情页，When 点击‘加入心愿单’按钮，Then 该商品应出现在用户的心愿单列表中，并显示添加成功提示”）。
介绍
在软件开发或产品设计过程中，我们常常会遇到功能描述模糊、需求不明确的问题，这导致后续开发、测试和验收缺乏统一标准，容易产生误解和返工。本技能旨在解决这一痛点，它能将用户用自然语言描述的、相对模糊的功能想法或需求，转化为结构清晰、包含具体验收标准的规格说明书（Specifications）。
使用时，您只需向AI提供一段关于某个功能或特性的描述，例如“我们需要一个用户登录功能”。AI会引导您补充必要信息，或直接基于现有描述，生成包含用户故事、功能场景、具体验收条件（Given-When-Then格式）等要素的详细规格文档。这个过程有助于澄清需求细节，确保各方对功能的理解一致。
该技能特别适合产品经理、项目经理、测试工程师以及需要将业务需求转化为技术语言的全栈或后端开发人员。对于初创团队或敏捷开发流程中，快速定义和确认迭代范围非常有帮助。
建议在使用时，尽量提供初始的、相对完整的功能背景和目标。虽然AI会协助细化，但更清晰的输入能产出更精准的规格。生成的规格书可作为开发任务卡、测试用例的基础，但复杂系统或涉及深度业务逻辑的部分，仍需人工结合领域知识进行最终评审和确认。
核心特点
专注于将非结构化的功能描述转化为包含具体、可验证验收条件（Acceptance Criteria）的测试用例规格，而不仅仅是生成功能列表或用户故事；其输出格式更贴近行为驱动开发（BDD）的 Given-When-Then 模板，直接服务于开发和测试环节。
注意事项
不适合将高度抽象的战略目标或极其复杂、涉及多系统交互的史诗级需求直接拆解为可执行的开发任务。
常见问题
这个技能能代替产品经理写PRD吗？
不能完全代替，它擅长将具体的功能点转化为可测试的规格，是PRD中“功能详情”部分的有力补充，但缺乏市场分析、竞品分析、整体产品路线图等宏观内容。
生成的规格可以直接用作测试用例吗？
是的，其输出的验收条件（Acceptance Criteria）通常采用 Given-When-Then 格式，测试工程师可以很方便地将其转化为自动化测试脚本的输入或手动测试用例。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x/raw/index.md（查看排版版本）