1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | vibe-check |
| 作者/维护者 | Amer Arab（GitHub 账号 TexasBedouin） |
| 来源链接 | https://github.com/TexasBedouin/vibe-check |
| 许可证 | MIT（GitHub API） |
| GitHub Stars | 509（GitHub API） |
| Forks | 53（GitHub API） |
| 最新版本 | v2.6.1（2026-07-17 发布） |
| 安装方式 | 一条命令通过开源 skills CLI 安装，或直接 git clone |
2. 功能介绍与亮点
vibe-check 把“从一个模糊想法到一份可交给编码 Agent 执行的完整蓝图”这段产品经理工作，封装成结构化技能：
- 发现：Reddit 痛点调研 + 竞品差距分析 + ODI 机会打分，找出真正值得解决的问题
- 验证：五视角直觉核查，给出是否值得做的结论
- 体验与规划：Crazy 8s 草图、完整用户旅程、Story Mapping 分层排布功能
- 技术架构：架构图、技术栈选型理由、数据模型、成本估算
- 风险与增长：把最冒险的假设设为编码前必须先跑通的第 0 阶段，并提前设计获客循环
- 构建阶段：带编号检查点，AI 每阶段结束后解释做了什么、为什么、接下来是什么
支持“完整流程 / 只验证 / 只规划”三种起点。产出两份文件：给编码 Agent 的 Markdown 说明书，以及给人看的单文件可交互 HTML 需求文档。examples/ 目录附三份真实会话样例，含一个已上线产品 ClearList 案例。
3. 适用场景
所属固定分类：元技能与 Agent 增强。面向没有工程背景、只有一个应用想法的完全新手；也适合已经能靠“氛围编码”做出界面雏形、但缺乏系统性规划能力的独立开发者。核心价值是在写第一行代码之前，把“要不要做”“做给谁”“怎么做”这三件事想清楚。
4. 跨 Agent 兼容性
- Claude Code：原生支持——标准
SKILL.md格式，可通过开源的 Vercel Labs skills CLI（npx skills add）一条命令安装，也可直接 clone 进.claude/skills/ - Codex：支持——仓库文档明确列出 Codex 为受支持平台，同样走 skills CLI 的跨 Agent 兼容层
- OpenClaw / Hermes Agent：未验证——材料中未提及，技能本身是纯 Markdown 提示词（无脚本、无平台专有钩子），理论上复制
SKILL.md内容到系统提示即可使用，但缺乏这两个平台的直接验证证据
5. 推荐理由
市面上大多数编码类技能都假设“你已经知道要造什么”，vibe-check 补的是更前面的那一段——把 Design Sprint、Jobs-to-Be-Done、Outcome-Driven Innovation、Growth Loops 等产品方法论揉合成一套可执行流程，让完全不懂工程的人也能在动手之前拿到一份经过验证、可执行的蓝图。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 上线约 7 周积累 509 GitHub Stars、53 Forks，21 个版本持续迭代，落在 200-1k 区间 |
| 可用性 | 9 | 一条命令安装或直接 clone；纯提示词无需任何 API Key 或付费依赖；SKILL.md、CHANGELOG、参考文档与三份完整示例齐全；4 天前仍有版本发布 |
| 安全性 | 10 | 纯 Markdown/提示词技能，仓库内无可执行脚本、无独立网络调用、不经手任何凭据；文件树中最大文件是示例 HTML 与图片，无不可审计的打包代码 |
综合评分：8.3
安全检查清单：① Shell 命令——无 ② 联网外发——无独立网络调用，“Reddit 调研”步骤是引导宿主 Agent 自行检索公开信息 ③ API Key/凭据——不需要 ④ 可疑指令——README、SKILL.md 与示例文件未发现提示注入 ⑤ 作者信誉——公开真实身份与从业背景，附真实上线产品案例；README 透明列出作者本人的付费咨询链接，属可选增值项 ⑥ License——MIT，明确 ⑦ 最近维护——2026-07-17 发布 v2.6.1，距今 4 天
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 vibe-check 的差异 |
|---|---|---|
| grill-me（Matt Pocock 出品） | 对着一个已确定的任务反复追问，逼出双方对需求的共同理解 | 聚焦单次任务的需求澄清对话，不产出完整的产品规划、架构与增长设计 |
| grill-me-skill（RobMitt） | 同样是追问式的需求澄清工具 | 与 grill-me 定位类似，输出是澄清后的共识，而非结构化的可交付蓝图 |
vibe-check 覆盖链条更长：从“是否值得做”的验证，到用户旅程、架构、增长设计与分阶段构建指导，产出一整套多文件蓝图，而非一次问答式的需求澄清。
8. 用户评价
该技能目前在第三方平台的独立讨论较少，Hacker News 上的 Show HN 帖子关注度有限，尚未找到经核实的具名第三方用户评价。
9. 其他补充
仓库遵循语义化版本号并维护 CHANGELOG，examples/ 目录内三份真实会话记录（含验证未通过、验证通过转规划两种结局）可作为效果预览；作者曾在 Product Hunt 发布该技能。
10. 安装使用方式
- Claude Code：
npx skills add TexasBedouin/vibe-check，或git clone https://github.com/TexasBedouin/vibe-check .claude/skills/vibe-check - 其他支持 SKILL.md 标准的工具：将
SKILL.md内容复制进系统提示或项目指令 - 安装后无需重启，直接对话触发，例如：“Use the vibe-check skill to help me plan my app.”，或指定入口：“Is my idea worth building? Reality-check it with vibe-check.”
- 更新：CLI 安装用
npx skills update；clone 安装进入技能目录执行git pull
11. 注意事项
- 仅在 Claude Code、Codex 的材料中有明确验证支持，OpenClaw、Hermes Agent 上的表现未经验证
- 属规划与方法论工具，不生成或修改实际代码，产出的蓝图仍需衔接其他编码技能才能落地
- 流程中的“Reddit 痛点调研”依赖宿主 Agent 自身的网络访问能力，若运行环境未开放联网工具，该步骤可能无法执行
- README 中包含作者本人的付费咨询/审计服务链接，为可选增值服务，非使用本技能的必要前提