Vibecoding 产品需求对齐框架:在写代码前把需求与规划对齐

前言

用 AI 做产品或新功能时,常见情况是:模型产出一份看起来很完整的设计说明,但表述偏工程化;你难以判断是否真懂你的意图,往往在实现推进一段时间后才发现方向偏了。下面介绍社区 Skill「Vibecoding产品需求对齐框架」(坐标 @user_cc55d0c3/product-alignment),它用两阶段、可复用的 prompt 流程,把「先对齐、再规划、最后才实现」固定成不可跳过的步骤。

这是什么

Vibecoding产品需求对齐框架(包内也称 Product Alignment)是一套基于通用 SKILL.md 格式的 Agent Skill:先通过复述与追问完成需求对齐,再通过「批判性产品规划」做自我审查,在动手写代码之前建立双重制约。

  • 维护方:SkillHub 社区发布者 user_cc55d0c3
  • 版本:1.0.0
  • 分类:business-ops(SkillHub)
  • 来源:community
  • 依赖:requires_api_key=false,无需 API Key

官方页面:SkillHub — Vibecoding产品需求对齐框架

核心功能

Skill 正文只包含流程定义与两段可复制 prompt,没有额外脚本或外部服务。

阶段一:需求对齐

在讨论新产品想法、新功能或重大调整时,先于任何设计与实现,让 Agent 按步骤执行(每步需你确认后再继续):

  1. 复述与追问:用 Agent 自己的话复述需求,并用日常中文描述场景(谁、在什么情况下、做什么、得到什么);提出至少 3 个「必须弄清才能往下走」的追问。
  2. 边界确认:列出核心必做、可延后、明确不做三类边界,每项附一句判断理由。
  3. 逐条对齐:对边界清单逐项向你确认,全部确认后才进入规划阶段。

阶段二:批判性规划

阶段一完成后,要求 Agent 输出结构化规划(简洁中文、单项控制在约 3 句话内),包括:

  1. 产品内核(是什么 / 不是什么)
  2. 核心路径(从打开到完成关键任务的步骤)
  3. 最大假设(1–2 个高风险假设及假设不成立时的影响)
  4. 自我批判(逻辑、迎合、逃避难题、被忽略的更简单做法)
  5. 替代方案(2–3 条与当前方案本质不同的路径)
  6. 推荐决策(最终推荐、理由与需提醒的风险)

在你审阅并确认之前,不进行代码实现。

设计取向

Skill 强调:输出应是你能一眼看懂、能快速判断的内容;Agent 先用你的语言复述与追问,再在规划阶段强制自我批判,把错误尽量留在「便宜的阶段」暴露,而不是默认信任「我理解了」或一份偏技术侧的设计文档。

安装与启用

安装 SkillHub CLI(若尚未安装)

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装说明 执行:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认目录可能不会被识别。

skillhub install product-alignment --namespace user_cc55d0c3 --dir <你的 skills 目录>

常见路径示例(以你实际环境为准):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

也可让 Agent 按官方安装文档处理:参考 https://skillhub.cn/install/skillhub.md,安装 @user_cc55d0c3/product-alignment。

安装后按所用客户端要求加载 skills(部分环境需重启或刷新后生效)。

不通过 SkillHub 使用

包内 README.md 说明:可将 SKILL.md 中的两段 prompt 复制到任意 AI 对话中使用,不依赖 CLI。

典型用法

适用时机(来自 SKILL.md):有新产品想法、新功能需求,或对现有项目做重大调整时,在所有代码实现之前启用本 Skill 或粘贴对应 prompt。

阶段一:向 Agent 发送 SKILL.md 中「阶段一:需求对齐」的完整 prompt,按「复述与追问 → 边界确认 → 逐条对齐」逐步确认。

阶段二:对齐完成后,发送「阶段二:批判性规划」的 prompt,审阅六部分输出后再决定是否进入实现。

若使用 Claude Cowork,包内 README.md 写明该 skill 已内置,可在对话中调用 product-alignment(其他客户端以本地安装的 SKILL.md 为准)。

适用场景与注意

适合谁

  • 产品负责人、独立开发者或用小团队做 MVP 时,希望 Agent 先对齐业务语言再写代码。
  • 需要在短流程内固定「禁止未确认就实现」纪律的场景。

限制与注意

  • 本 Skill 是 prompt 流程框架,不包含代码生成、项目管理或自动化测试;价值在于对齐与规划结构,而非替代具体技术方案。
  • 阶段一要求逐步确认,不适合需要立刻出可运行原型、且可接受返工的场景。
  • SkillHub 页面展示的评分为平台计分方式下的数值(抓取时为 100000),下载量会随时间变化;以 官方 Skill 页 为准。
  • 包内 README.md 提到配套文章文件名 ai-zuo-chan-pin-bu-dui-qi-wen-ti.md;当前通过 skillhub install 拉取的 1.0.0 包中主要文件为 SKILL.md 与 README.md,若需长文可查阅发布者说明或 SkillHub 详情。

结尾

Vibecoding产品需求对齐框架把「需求对齐」和「批判性规划」写成可重复的两段 prompt,适合在 Vibe coding 或 Agent 辅助开发里,把交接点从「信任设计文档」改成「逐步确认、先批判再动手」。安装与说明见 https://www.skillhub.cn/skills/user_cc55d0c3/product-alignment,坐标 @user_cc55d0c3/product-alignment,版本 1.0.0。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜