spec-writing
从功能描述生成可测试的规格说明
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：spec-writing。 它的用途是：从功能描述生成可测试的规格说明 完整的 Skill 内容见：https://321skill.com/skills/spec-writing-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'为我们的电商平台新增“猜你喜欢”功能，用户故事：作为用户，我希望看到个性化的商品推荐，以便快速找到感兴趣的商品。' 它会生成包含功能描述、验收标准（如推荐列表加载速度、准确性指标）、测试要点（如空数据状态、不同用户画像的推荐差异）的完整规格说明文档。
介绍
spec-writing 是一个专门解决需求文档与开发实现之间脱节问题的工具。它从用户故事和功能描述出发，自动生成结构清晰、可测试的规格说明，帮助团队在编码前对齐预期，减少因需求模糊导致的返工和沟通成本。
使用时，你只需提供功能描述或用户故事，spec-writing 会基于最佳实践模板，输出包含功能概述、验收标准、边界条件、测试要点等内容的规格文档。它支持迭代优化，你可以根据反馈调整输出，确保最终文档既符合业务逻辑又具备技术可执行性。
适用于产品经理、项目经理、文档工程师以及任何需要撰写清晰功能规格的团队角色。尤其适合敏捷开发中需要快速产出用户故事验收标准、或传统瀑布流程中需要编写详细设计文档的场景。
建议将 spec-writing 生成的规格说明作为团队评审和开发任务的输入，而非直接替代人工审查。对于高度创意或非结构化需求，可能需要结合人工判断进行调整。同时，定期更新规格说明以保持与代码实现同步。
核心特点
与同类工具相比，spec-writing 的核心优势在于从用户故事出发，自动生成包含验收条件和测试要点的完整规格，而非仅输出功能列表或需求描述，更贴近测试驱动开发（TDD）的实践。
注意事项
不适合需要高度创意、非结构化或缺乏明确用户故事输入的需求场景。
常见问题
spec-writing 支持哪些输入格式？
支持自然语言描述、用户故事模板（As a... I want... So that...）、以及结构化功能要点。你可以直接描述或粘贴已有的需求文档段落。
生成的规格说明可以直接用于测试用例吗？
可以。输出包含详细的验收标准和测试要点，测试团队可据此直接编写测试用例，但建议结合具体环境进行微调。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-writing-x-5/raw/index.md 读取 spec-writing 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-writing-x-5/raw/index.md（查看排版版本）