Openspec 规范驱动开发工作流-需求文档篇

张开发
• 2026/4/17 19:27:50 • 15 分钟阅读

最新文章

推荐文章

相关文章

分享文章

Openspec 规范驱动开发工作流-需求文档篇
背景使用 openspec 工作流进行开发投喂的需求文档要如何规范编写工作流简介OpenSpec 的 propose 阶段会读取需求描述自动生成三个核心产物AI 会基于需求文档 项目上下文config.yaml 中定义的技术栈、架构约定、AGENTS.md来生成这些产物。需求文档的质量直接决定了产物质量。产品需求文档的建议1. 明确的内容2. 可选明确的内容可以大幅提升 AI 产物质量3. 格式建议# 【产品名】功能名称 来源[文档链接] 日期YYYY/MM/DD ## 背景 为什么做解决什么问题 ## 目标 1. 目标 1 2. 目标 2 ## 非目标有则填 - 不涉及 xxx - 不修改 xxx ## 触发条件 ### 场景 Axxx - 触发路径描述 ### 场景 Bxxx - 触发路径描述 ## 行为规则 - 用户操作 A → 系统行为 A - 用户操作 B → 系统行为 B - 异常情况刷新/关闭 → 行为描述 ## 疲劳度 / 频率控制可选 - 关闭后 N 天再弹 - 接受/拒绝后永不再弹 - 在线参数控制说明 ## UI / 展示内容有设计稿则不用写无则必写 - 位置、尺寸、样式要求 - 文案内容标题、描述、按钮文案 - 动画要求 ## 可配置项 - 在线参数名 类型 默认值 - 配置规则说明 ## 回退方案 - 如何不发版快速下线 ## 投放时间可选 持续 N 天4. 常见问题 反模式总结核心原则需求文档越结构化、越场景化OpenSpec 生成的 proposal/design/tasks/spec 质量越高。最关键的三点触发条件要穷举 — 每个触发路径单独列出行为规则用当…则…格式 — AI 会直接转为 spec 场景写清非目标和边界 — 防止 AI 过度实现或遗漏异常处理产品设计agent-skillsAI辅助产品设计

更多文章