OpenSpec:让AI先写规格说明书,再动手做设计

13次阅读

做产品的人都知道一个道理:写代码之前,先写 Spec

但实际开发中,AI 总是忍不住马上开始写代码——你给它一个 prompt,它就开始生成页面,而不是先问 ” 你要解决什么问题 ”、” 目标用户是谁 ”、” 成功指标是什么 ”。

Open Design 生态里的 pm-spec Skill,就是来解决这个问题的——让 AI 在动手之前先写规格说明书,而且要按照专业的格式写。

OpenSpec 不是一个新的独立工具,而是 Open Design 生态里 137 个 Skills 中的一个,名为 pm-spec

它的核心理念:

Prompt Choreography — The interactive question form pops before a single pixel is improvised. 30 seconds of questions beats 30 minutes of redirects.

在 AI 开始生成任何设计产物之前,先用一套结构化的问题表单了解清楚:产品背景、目标用户、核心场景、优先级。然后才开始动手。

pm-spec 的工作流分为几个阶段:

Detect → Discover → Direct → Deliver
  ↑                          ↓
  ←←←←←←← Spec 文档锁定 ←←←←←←
  1. Detect:守护进程扫描 $PATH,自动识别 12 种编码 Agent
  2. Discover:Turn 1 是一个问题表单——产品背景、目标用户、核心场景、交付范围
  3. Direct:从 5 个视觉方向中选择一个(Editorial Monocle、Modern Minimal、Warm Soft、Tech Utility、Brutalist Experimental)
  4. Deliver:生成 Spec 文档 → 确认 → 开始设计产物

关键在 Discover 阶段——30 秒的提问,锁定产品规格,避免之后反复改方向。

一份合格的 pm-spec 输出包含:

章节 内容
产品背景 解决什么问题,为什么现在做
目标用户 谁用、他们的痛点是什么
核心场景 主要使用流程,关键节点
成功指标 怎么衡量产品成功
优先级 P0/P1/P2,当前版本做什么
约束条件 技术限制、品牌规范、资源限制

这不是给开发者看的技术文档,是给 AI 看的 产品决策文档

很多 AI 设计工具的问题是:上来就生成页面,结果生成的页面和用户想要的完全不一样,然后反复修改,浪费时间。

OpenSpec 的逻辑是:把决策前置

30 秒的问题,换来的是:

  • AI 不会偏离产品方向
  • 设计产物有清晰的质量标准
  • 后续开发有文档可依
  • 减少返工和重复

Open Design 有 137 个 Skills,pm-spec 是其中专门负责 ” 规格说明书 ” 的一个。

open-design 生态
    ├── pm-spec          ← 产品规格(Spec)├── web-prototype    ← Web 原型
    ├── dashboard        ← 仪表盘
    ├── saas-landing     ← SaaS 落地页
    ├── guizang-ppt      ← 幻灯片
    ├── wireframe-sketch ← 线框图
    └── ... 共 137 个

pm-spec 通常是第一个触发的 Skill——先写规格说明书,再选择具体的设计技能。

OpenSpec 不是孤立的,它是整个 AI 开发栈的一环:

OpenSpec(产品规格)→ open-design(设计执行)→ opchain(开发流程)→ gbrain(知识记忆)

或者从 superpowers 的视角:

brainstorm(设计讨论)→ pm-spec(规格确认)→ superpowers(TDD 执行)

pm-spec 内置于 open-design,安装 open-design 后即可使用:

git clone https://github.com/nexu-io/open-design.git
cd open-design
pnpm install
pnpm tools-dev
  • 产品经理:想让 AI 生成的需求文档符合专业格式

  • 设计师:希望设计方向在动手前被用户确认,避免返工

  • 开发者:需要清晰的规格说明书再开始编码

  • 团队:需要统一的产品语言,减少沟通误差

  • 依赖 open-design:不是独立工具,需要在 open-design 生态下使用

  • 问题表单质量:如果问题设计得不好,Spec 质量也会受影响

  • 中文支持:主要是英文界面,中文产品可能需要本地化

OpenSpec(pm-spec)解决的核心问题是:AI 动手之前,先对齐产品方向

30 秒的问题,换来的是清晰的规格说明书和更低的设计返工率。这是把 ” 产品思维 ” 前置到 AI 工作流的第一步。

在 Open Design 的 137 个 Skills 里,pm-spec 是入口——先写规格说明书,再选择合适的技能开始设计。

相关链接:

END

从 GStack 到 OpenSpec,一个完整的 AI 产品开发栈正在变得可视化。

正文完