vibe-coding-requirements
Vibe Coding（用 AI 写代码）项目的第一步：把模糊的想法，变成 AI 能精准落地、不会跑偏的需求。 当用户说"我想做一个 XX"、"帮我用 AI 做个 demo"、"我有个想法想验证"、"帮我跟 AI 对齐需求"， 或者描述了一个还很模糊的软件/工具/系统点子时，使用此 Skill。也用于先判断"这件事到底要不要写代码"。 这是 vibe-coding-kit 套件的入口——只想跑 demo 验证想法的人，通常只需要这一个 Skill。 它不止教你说清"想要什么"，还教你用"数据旅程 + 3×4 提问"把需求补全到考虑周全，避免只描述了"一切顺利"的happy path。 即使用户没明说"规划"二字，只要 ta 准备让 AI 开始写代码、却还没把需求说清楚，就应主动用本 Skill 先做需求对齐。
npx skills add Junliu1066/vibe-coding-kit --skill vibe-coding-requirements --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 需求对齐：把想法说成 AI 能落地的需求 这是 **vibe-coding-kit** 的入口 Skill。它服务的人多半不写代码，靠 AI 把想法变成能跑的东西。最容易踩的坑不是技术，而是**需求没说清，AI 朝着错误方向飞速实现**。把需求说对，后面省一半返工。 > **套件里还有三个 Skill，在不同时刻用：** > - 需要选技术栈 / 看不懂 AI 给的方案 → `vibe-coding-architecture` > - demo 验证过了、要做成正式系统 → `vibe-coding-production` > - 开发中 AI 越改越乱 / 改坏退不回去 / AI 忘事 → `vibe-coding-survival`（开发全程都建议配合它） ## 先确认：用户现在在哪一站？ | 用户想要 | 怎么办 | |---------|-------| | 还不确定要不要做 | 先做**阶段零**，可能根本不用写代码 | | 快速跑个 demo 验证想法 | **阶段零 + 阶段一**，需求说清就开干，其余先不管 | | demo 过了，要做成正式系统 | 做完本 Skill，转 `vibe-coding-architecture` 和 `vibe-coding-production` | | 已经在做、过程中失控 | 转 `vibe-coding-survival` | 判断方法：直接问。"你现在是想先跑个 demo 看看效果，还是打算做一个要长期运行、可能给别人用的正式系统？" --- ## 开问之前：先分诊，能推断的别问 ★ > **账本（流程状态）：** 本 skill 是流程第一阶段 **S1·需求对齐**的"自助路径"（访谈式入口是 `vibe-coding-prd`，两者满足同一个 S1）。开始前读一下 `docs/进度账本.md`（不存在就照 `examples/进度账本-模板.md` 建一个，初始化到 S1）；这里的"分诊"结论就是账本里 S1.1 的轻/重判定，产出"需求基准描述"对应 S1 的核心退出条件。轻量 demo 不必逐步报门，但**别跳过分诊和四要素**。 新手最容易把对齐做成"审问"——一口气抛十几个问题，用户答到一半就烦了。**好的需求对齐，问得少而准。** 在准备每一个问题前，先过这条原则： > **能自己（或从用户已经说的话）推断出来的，就别问；只把真需要用户拍板的留成问题。** 具体两步： 1. **先分诊，定深度。** 用一句话判断这个需求的"分量"，深度随风险走： - **轻**（自己用、一次性、跑个 demo）→ 只问最关键的一两件事，快速进入"补全"。 - **重**（要给别人用、要长期运行、一旦出错有代价）→ 四要素逐项问，再做"数据旅程"深扫。 2. **能推断的，转成"推荐项"让用户一眼确
- 先确认：用户现在在哪一站？
- 开问之前：先分诊，能推断的别问 ★
- 推荐选项写法：别让用户面对空白，也别替他做主
- 阶段零：先别急着写代码
- 阶段一：需求澄清（四要素框架）★ 核心
- 1.1 先分清"想要什么"和"想解决什么"
- 1.2 用四要素框架描述需求
- 1.3 哪些要写清楚，哪些留给 AI
- 1.4 demo 跑出来不对，怎么办（关键技能）
- 1.5 范例对照
- 阶段一·进阶：把需求"补全"——从一切顺利，到考虑周全 ★
- 复用你的强项：用户旅程 → 数据旅程
- 对每一步，问 3×4 个问题（漏网之鱼生成器）
- 交给 AI 写之前，换三个身份把需求读一遍（自检）
What does the vibe-coding-requirements skill do?
Vibe Coding（用 AI 写代码）项目的第一步：把模糊的想法，变成 AI 能精准落地、不会跑偏的需求。 当用户说"我想做一个 XX"、"帮我用 AI 做个 demo"、"我有个想法想验证"、"帮我跟 AI 对齐需求"， 或者描述了一个还很模糊的软件/工具/系统点子时，使用此 Skill。也用于先判断"这件事到底要不要写代码"。 这是 vibe-coding-kit 套件的入口——只想跑 demo 验证想法的人，通常只需要这一个 Skill。 它不止教你说清"想要什么"，还教你用"数据旅程 + 3×4 提问"把需求补全到考虑周全，避免只描述了"一切顺利"的happy path。 即使用户没明说"规划"二字，只要 ta 准备让 AI 开始写代码、却还没把需求说清楚，就应主动用本 Skill 先做需求对齐。
How do I install it?
Run `npx skills add Junliu1066/vibe-coding-kit --skill vibe-coding-requirements --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Junliu1066/vibe-coding-kit, a repository with 150 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.