easy-product-builder 是一个通过连续追问,把一句话需求挖掘成产品规格文档的 skill。
它适合这样一类场景:用户脑子里已经有方向,但流程、规则、页面、状态、边界、视觉方向还没真正想清楚。这个 skill 的默认工作方式不是问两轮就写,也不是无休止盘问,而是:
- 先展示一份探讨计划,与用户对齐这次会从哪些方面推进
- 最先确认项目或产品名称
- 先建立会影响 spec 的问题矩阵
- 按主题持续追问必要问题
- 每轮固定只问 3 个问题,并在内部更新 spec 草稿
- 关键问题域覆盖完成后,再输出完整文档
默认输出仍然聚焦两类核心文档:
.easy-coding/spec/Product-Spec.md.easy-coding/spec/UI-Spec.md
其中 UI-Spec.md 不再只写页面和交互,也会正式纳入:
- 视觉方向
- 主题色与色彩策略
- 风格关键词与界面气质
- 布局倾向与信息密度
- 组件表现偏好
- 默认采用“深挖但有限”的追问方式
- 正式产品设计阶段前,会先展示一份可补充、可修改的探讨计划,并等待用户显式确认
- 项目或产品名称会被优先确认
- 每轮固定只问 3 个问题,可以问很多轮,但每轮都足够聚焦
- 选择题统一使用
A/B/C/D形式,用户可以直接回复字母 - 所有 spec 默认统一写入
.easy-coding/spec/,不散落在项目根目录 - 文档采用“内部渐进草稿、最终集中展示”的方式,默认不直接覆盖正式规格;必要时才写入
_draft中间稿 - 每轮提问前会先参考已完成文档,再决定下一轮最值得追问的 3 个问题
- 未定信息会被标记为
[待确认]或当前假设,而不是偷偷脑补 - 只要识别到有 UI,就会同时深挖信息架构、交互行为和视觉方向
- 当用户缺少 UI 想法时,AI 会基于产品类型给出 2-3 套方向建议和取舍,而不是静态猜测
- 从 0 到 1 设计一个新产品、应用、工具或内部系统
- 对已有产品新增功能并更新产品规格
- 将聊天式需求讨论整理成结构化 spec
- 为有界面的产品补充页面结构、交互说明和视觉方向
- 市场分析、商业论证、立项判断
- 输出 MRD
- 编写代码、接口设计、技术实现方案
- 直接做开发任务拆解
产品部分至少会检查:
- 项目或产品名称
- 目标、成功标准与关键指标
- 用户与场景
- 范围与非目标
- 流程与分支
- 对象、字段、状态
- 规则、权限、异常
- 数据与系统约束
如果识别到有 UI,还会额外检查:
- 信息架构与页面承载
- 页面交互与状态
- 可访问性与可用性约束
- 视觉方向与界面风格
每轮对话后,skill 都会先更新内部决策账本与 Product / UI 草稿:
- 新确认的内容写入对应章节
- 未定项标记为
[待确认] - 用户允许 AI 先代补的内容标记为
当前假设
正式规格只在问题矩阵覆盖完成后写入 .easy-coding/spec/。如果用户明确要求中途落盘,才会把中间版本写入 .easy-coding/spec/_draft/。
正式产品设计阶段中,每轮固定只问 3 个问题。下一轮提问前,会先回看当前草稿,再决定最值得继续问的 3 个问题。
对用户只同步当前理解、已锁定项、待确认项和下一轮问题主题,不会每轮都抛出整份半成品文档。
第一层:信息架构
- 页面范围
- 默认入口
- 导航结构
- 页面目标
- 页面之间的任务承载关系
第二层:交互行为
- 主操作、次操作、关键字段
- 零状态、空状态、加载态、错误态、权限态
- 列表、详情、编辑、批量操作联动
- 弹窗、抽屉、二级页触发条件
第三层:视觉方向
- 主题色组合
- 风格偏好
- 布局倾向
- 信息密度
- 组件气质
- 参考产品
- 品牌约束与视觉禁忌
例如:
- 更偏效率工具:适合高频操作,但界面更硬核
- 更偏品牌体验:视觉记忆点更强,但信息承载较弱
- 更偏数据工作台:适合监控分析,但复杂度更高
AI 会给推荐结论,并把未拍板内容标记为 当前假设,而不是直接写成既定方案。
所有需要用户选择方向的地方,都会使用 A/B/C/D 选项格式,方便用户直接回字母。
项目当前包含以下参考模板:
- SKILL.md
- references/product-spec-template.md
- references/ui-spec-template.md
- references/changelog-template.md
- references/system-prompt-template.md
- references/ui-prompt-template.md
- “帮我把这个一句话需求梳理成 Product Spec”
- “我有个模糊的后台工具想法,帮我把流程、规则和 UI 一起问清楚”
- “帮我更新现有规格,同时把 UI 的视觉方向也补到 UI Spec”
- “先别写代码,先给我一份探讨计划,再一轮轮把产品、页面和风格方案问清楚”