spec-writing
将功能描述转化为清晰可测试的规格说明书
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：将功能描述转化为清晰可测试的规格说明书 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请根据以下用户故事生成规格说明书：作为一个电商平台卖家，我希望能够批量编辑商品价格，以便快速调整促销活动。' 它会输出包含前提条件、正常流程、异常流程（如价格范围校验）、验收标准（如编辑后价格更新不超过10秒）的文档，格式为Markdown表格。
介绍
在需求文档编写中，常常面临描述模糊、无法直接测试、开发与测试理解不一致等问题。本 Skill 通过解析功能描述和用户故事，自动生成结构化的、可量化的规格说明书，包含前提条件、触发事件、预期行为、验收标准等关键要素，确保每个需求都具备可测试性。
使用方式非常简单：提供一段功能描述或用户故事文本，该 Skill 会识别其中的角色、动作、输入输出和边界条件，然后输出一份规范的规格说明书。你可以指定输出格式（如 Markdown、表格、JSON 等），也可以要求添加错误场景、性能要求或非功能约束。
适合产品经理快速将初步想法固化为可交付的 PRD 文档，适合项目经理在需求评审前统一团队理解，也适合文档工程师编写清晰的技术规格。也适合开发者在编码前先定义清晰的验收标准，减少返工。
建议在需求早期阶段使用，避免后期频繁变更。对于非常复杂或涉及大量领域规则的需求，建议先人工梳理关键逻辑，再借助此 Skill 生成初稿，最后人工复核。注意生成的规格说明书需要结合业务上下文进行微调，不可直接作为最终交付物。
核心特点
与通用需求文档生成工具不同，此 Skill 强制要求每个规格都包含可测试的验收标准（Given/When/Then 格式），并自动识别用户故事中的隐含边界条件，减少遗漏。
注意事项
不适用于高度非结构化的创意类需求（如 UI 设计灵感），也不适合需要大量图片或原型图辅助说明的场景。
常见问题
能生成测试用例吗？
可以生成模块级别的验收测试用例，但通常不包含详细步骤或测试数据，需结合测试框架进一步细化。
支持中文用户故事吗？
支持中英文，但建议使用英文关键词（如 Given/When/Then）以获得更稳定的输出，中文场景下需人工校准词汇。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x-7/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x-7/raw/index.md（查看排版版本）