spec-writing
从功能描述生成清晰可测试的规格说明
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：从功能描述生成清晰可测试的规格说明 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'根据以下功能描述和用户故事，生成一份清晰可测试的规格说明：用户登录功能，用户故事：作为注册用户，我希望通过邮箱和密码登录，以便访问我的个人主页。' 它会输出包含前置条件（用户已注册邮箱、密码正确）、后置条件（登录成功跳转主页）、验收条件（输入正确邮箱密码可登录、错误密码提示错误信息、连续5次失败锁定账号30分钟等）的完整规格文档。
介绍
在软件开发中，需求不明确、规格模糊是导致返工和沟通成本高的主要原因。spec-writing 技能专为解决这一问题而生：它能将自然语言的功能描述和用户故事，转化为结构化的、可测试的规格说明文档，确保每个功能点都有明确的验收标准、前置条件、后置条件和边界场景。
使用方式非常简单：你只需提供功能描述和目标用户故事，技能会自动解析关键信息，生成包含用例、验收条件、约束规则和测试要点的规格文档。你可以通过对话逐步细化需求，技能会迭代更新规格，直到满足你的要求。整个过程无需手动编写模板，极大提升文档产出效率。
本技能适合产品经理、项目经理、文档工程师以及参与需求梳理的全栈/后端开发者。尤其适用于敏捷团队在冲刺规划阶段快速产出可执行的规格，也适合外包项目中作为需求交付的标准化输出。
建议在使用时尽量提供完整的用户故事（角色、愿望、价值），并明确期望的输入/输出格式。如果功能涉及复杂交互或状态机，可以分步描述，让技能逐步生成完整的规格。注意，本技能更擅长文本化规格，不适合需要图形化流程图或界面原型的场景。
核心特点
区别于其他文档生成工具，spec-writing 不仅输出结构化规格，还自动将用户故事转化为可验证的验收条件，并识别边界情况和异常流程，确保规格具备可测试性。
注意事项
不适合需要图形化流程图、界面原型或高度技术性设计文档的场景，且对非常模糊或缺失用户故事的功能描述生成效果有限。
常见问题
如何安装 spec-writing？
可通过 npm 全局安装：npm install -g spec-writing，然后按照提示配置 AI 代理即可使用。
它支持哪些输入格式？
支持自然语言描述、结构化用户故事（角色-愿望-价值）及 Markdown 格式的已有需求片段。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x-6/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x-6/raw/index.md（查看排版版本）