spec-writing
将功能描述转化为清晰、可测试的规格说明
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：将功能描述转化为清晰、可测试的规格说明 完整的 Skill 内容见：https://321skill.com/skills/spec-writing/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我们需要一个用户注册功能，要求手机号验证，注册成功后跳转到个人中心。’，它会生成如“作为新用户，我希望通过手机号和验证码完成注册，以便使用平台的完整服务”的用户故事，并列出“1. 输入有效手机号并获取验证码”、“2. 输入正确验证码后成功注册”、“3. 注册后页面自动跳转至个人中心”等具体验收标准。
介绍
spec-writing 这个技能旨在解决产品需求或功能描述模糊、难以直接用于开发和测试的问题。它能够将一段自然语言描述的功能需求，自动转化为结构清晰、包含验收标准的规格说明（Specification），特别是生成用户故事（User Story）格式的文档。
使用时，你只需要向AI提供一段关于新功能、新特性或改进点的描述。AI会分析这段描述，识别出核心用户角色、具体操作流程以及期望的结果，然后生成一份包含“作为[角色]，我希望[目标]，以便[价值]”格式的用户故事，并附上详细的验收标准（Acceptance Criteria）。
这个技能特别适合产品经理、项目经理、需求分析师以及需要将模糊想法转化为具体开发任务的团队负责人。对于初创团队或敏捷开发团队，它能快速统一各方对需求的理解，减少沟通成本。
建议在需求讨论的早期或功能评审会前使用，以确保需求的可测试性和无歧义性。注意，生成的规格说明仍需人工复核，以确保其符合业务逻辑和团队的具体技术约束，它更适合作为需求澄清和结构化的起点，而非最终不可更改的文档。
核心特点
专注于从模糊的功能描述中生成结构化的用户故事和验收标准，而非简单的需求重述或任务列表；其输出直接面向敏捷开发和测试驱动开发（TDD）的工作流，提供了可直接用于编写测试用例的明确条件。
注意事项
不适合处理高度技术性、已有详细设计文档或涉及复杂业务规则推导的需求场景。
常见问题
能用它来写技术方案或API文档吗？
不能，它的核心是生成面向业务和测试的功能规格说明（用户故事和验收标准），不涉及具体的技术实现细节。
生成的用户故事格式可以自定义吗？
目前主要遵循标准的“As a... I want... So that...”格式，专注于生成清晰、可测试的验收条件，格式自定义能力有限。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing/raw/index.md（查看排版版本）