spec-writing
将模糊需求转化为清晰、可测试的规格说明
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：将模糊需求转化为清晰、可测试的规格说明 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我们需要一个用户注册功能，要求手机号验证，成功后跳转到个人资料完善页面。”，它会生成包含“注册用户”、“验证手机号”、“完善资料”等用户故事，并为每个故事定义清晰的验收条件，例如：“Given 用户进入注册页面，When 输入有效手机号并获取验证码，Then 系统应发送短信验证码至该手机。”
介绍
在软件开发中，产品经理或业务方提出的功能描述往往是模糊、不完整的，这给后续的开发和测试带来了巨大挑战。spec-writing 这个技能就是为了解决这个问题而生的。
它能够将自然语言描述的功能需求，自动转化为结构化的用户故事和清晰、可测试的规格说明。用户只需提供一段功能描述，它就能帮你拆解出角色、目标、验收标准等关键要素。
这个技能特别适合产品经理、项目经理、测试工程师以及需要将业务需求转化为技术语言的全栈或后端开发人员。它可以帮助团队在项目早期对齐认知，减少因需求理解偏差导致的返工。
建议在使用时，尽量提供详细、准确的原始需求描述。虽然它能处理模糊描述，但输入质量越高，输出的规格说明就越精确。同时，生成的规格说明仍需人工复核，以确保其符合具体的业务上下文和技术约束。
核心特点
专注于将模糊的功能描述转化为结构化的用户故事和可测试的验收标准，而非简单的需求重述或文档模板填充。其输出直接面向开发与测试，具备明确的“Given-When-Then”格式，便于自动化测试用例的编写。
注意事项
不适合处理高度技术性、已具备完整技术设计文档的需求，或需要深度领域专业知识（如特定金融、医疗法规）才能拆解的复杂业务规则。
常见问题
spec-writing 能生成测试用例吗？
不能直接生成可执行的测试代码，但能生成结构化的验收标准（如 Given-When-Then 格式），这是编写测试用例的直接输入和依据。
输入的需求描述需要多详细？
建议尽可能详细，但即使输入较为模糊，它也能通过提问和结构化来梳理需求。核心是描述清楚“谁”通过“什么功能”实现“什么价值”。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x-8/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x-8/raw/index.md（查看排版版本）