spec-writing
将模糊的功能描述转化为清晰、可测试的需求规格说明书。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：将模糊的功能描述转化为清晰、可测试的需求规格说明书。 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我们需要一个用户注册功能，要能通过邮箱和手机号注册，注册后需要邮箱验证。’，它会首先与你确认业务规则细节，然后生成如“作为一个新用户，我希望通过邮箱或手机号注册账户，以便使用核心服务”的用户故事，并附上详细的验收条件，例如‘给定未注册的邮箱，当用户提交有效邮箱和密码时，系统应发送验证邮件’等。
介绍
在软件开发或产品设计过程中，团队成员（如产品经理、业务方）提出的需求描述往往比较模糊、口语化，缺乏明确的验收标准，这给后续的开发、测试和验收带来了困难。Spec-writing Skill 旨在解决这一痛点，它能将非结构化的功能描述或想法，自动转化为包含用户故事（User Stories）、验收条件（Acceptance Criteria）等要素的、清晰且可测试的规格说明文档。
使用时，你只需向AI提供一段关于某个功能或特性的自然语言描述。AI会引导你澄清模糊点，并最终生成一份结构化的规格文档。这个过程通常包括识别角色、定义目标、拆解具体任务和设定明确的成功标准。
这个Skill非常适合产品经理、项目经理、业务分析师以及需要将业务需求转化为技术语言的全栈开发者和测试工程师。它帮助团队在项目早期对齐认知，减少因需求理解偏差导致的返工。
建议在使用时，尽可能提供详细、具体的初始描述，并积极参与AI的澄清提问。生成的规格文档可以作为团队讨论的基础，或直接导入到Jira、Confluence等项目管理工具中。注意，它生成的是需求文档而非技术设计，技术实现细节仍需开发团队后续补充。
核心特点
专注于从模糊描述到可测试规格的精准转化，其核心在于生成包含具体“验收条件”的文档，而非简单的需求重述或任务列表，这直接对接了敏捷开发中的测试驱动开发（TDD）和行为驱动开发（BDD）实践。
注意事项
不适合生成高度技术性的架构设计文档或具体的代码实现方案。
常见问题
Spec-writing 能生成用户故事吗？
是的，它的核心输出就是包含角色、目标、验收条件的标准用户故事格式。
生成的规格可以直接用于开发吗？
可以作为开发的需求基线，但技术实现细节和更复杂的技术约束仍需开发团队评审和补充。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x-2/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x-2/raw/index.md（查看排版版本）