Skip to content
Back to search

vibe-coding-kit

不教你写代码,教你把"用 AI 写代码"彻底想明白 — 给非技术产品人的 vibe coding 规划工具包

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/junliu1066--vibe-coding-kit/badge.svg)](/listings/junliu1066--vibe-coding-kit)

HTML

<a href="/listings/junliu1066--vibe-coding-kit"><img src="/api/listings/junliu1066--vibe-coding-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 183 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/social-preview.png" alt="vibe-coding-kit — 需求没说清,等于没说" width="820">
  3. # vibe-coding-kit
  4. **不教你写代码,教你把"用 AI 写代码"这件事,彻底想明白。**
  5. *A planning toolkit for vibe coders who don't (yet) write code.*
  6. ![License](https://img.shields.io/badge/License-MIT-blue.svg)
  7. ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
  8. ![Made for](https://img.shields.io/badge/made%20for-Vibe%20Coders-ff69b4.svg)
  9. ![Language](https://img.shields.io/badge/lang-中文-red.svg)
  10. </div>
  11. ---
  12. > **需求没说清,等于没说。** AI 不会卡住——它会朝着错误的方向,飞速地、自信地,把你的项目实现出来。
  13. 如今谁都能把一个想法甩给 AI,几分钟跑出个能动的东西。但真正把它做成、做对、不半路崩掉的人,少得多。差距从来不在"会不会调 AI",而在两件事:**开工前有没有把需求想清楚,开工后有没有守住纪律。**
  14. 这套工具,就是把这两件事,拆成任何人都能照着做的步骤。
  15. ---
  16. ## 它解决什么
  17. 你大概经历过其中至少一种:
  18. - 想法很清楚,AI 写出来的却完全不是那回事,来回扯皮一下午。
  19. - demo 跑通了,越改越乱,最后连之前能用的版本都找不回来了。
  20. - AI 信誓旦旦说"已完成",你一跑,根本不行。
  21. - 面对它给的几个技术方案,你一个字都看不懂,只能闭眼选一个。
  22. 这些都不是技术问题,是**方法问题**。而方法,是可以学的。
  23. ## 30 秒看懂它的价值
  24. 同一个人,同一个想法,区别只在于"怎么说":
  25. <div align="center">
  26. <img src="assets/before-after.png" alt="模糊想法 vs 说清楚的需求" width="860">
  27. </div>
  28. 第二种,AI 能**直接开干,而且不会跑偏**。本套件做的,就是带你从第一种,走到第二种——并且一路护送到上线。
  29. ## 套件里有什么
  30. 六个轻量 Skill,**在你需要的那一刻,自动登场**:
  31. | Skill | 什么时候用 | 给你什么 |
  32. |-------|-----------|---------|
  33. | 💬 **prd** | "帮我理需求" / "帮我写个 PRD" / 想清楚再开工 | **访谈式 Agent**:一问一答 + 岔路口给建议,产出 PRD 文件 |
  34. | 🎯 **requirements** | "我想做个 X" / 跑 demo / 对齐需求 | 该不该写代码的自检 + 需求四要素 + 把需求补全 |
  35. | 🧭 **architecture** | 选技术栈 / 看不懂 AI 给的方案 | 看懂任何架构的 **6 个维度** + 选型五步法 |
  36. | 🚀 **production** | demo 想做成正式系统 / 部署上线 | 开发规范 + 安全基线 + 部署 + 验收 + 文档 |
  37. | 🛟 **survival** | "AI 越改越乱" / 改坏退不回去 / AI 忘事 | 贯穿全程四件事 + 红线 + 项目说明书 |
  38. | ✅ **harness** | 产出物写完后 / "帮我质检" / "检查合不合规" | **质检 Agent**:逐条校验产出格式、章节完整性、跨 Skill 一致性 |
  39. > **不知道从何说起?** 在 Claude Code / Codex 里直接用 `prd` 这个**访谈 Agent**——它会像产品顾问一样一点点问你,在你判断不了的地方(尤其"这东西该活在哪""用什么技术")给你选项和推荐,最后把 `prd.md` 写进你的项目目录。
  40. ### 🧬 Harness 治理层(新增)
  41. 除了六个 Skill,这套件现在自带一套**三层治理体系**,确保 AI 的每次产出格式统一、质量达标:
  42. | 层 | 文件 | 作用 |
  43. |----|------|------|
  44. | **Layer 1 · 宪法** | `CLAUDE.md` | AI 对话开始时自动加载的最高规则:语言、命名、必须章节、禁止事项 |
  45. | **Layer 2 · 质检** | `skills/vibe-coding-harness/` | 事后逐条校验产出物,报告违规 + 给出修复建议 |
  46. | **Layer 3 · 硬约束** | 每个 `SKILL.md` 末尾 | Skill 自己的交付前自检清单,不通过就不算做完 |
  47. 三层从 `harness.json`(根目录的结构化配置文件)统一派生,改一处,三处同步。**Claude Code 用户开箱即用**;ChatGPT/Codex 用户把 `CLAUDE.md` 贴到 system prompt 即可。
  48. > **流程治理(v2 新增):** 除了"管产出物",Harness 现在还"管过程"——`harness.json` 的 `workflow` 块把流程定义成 S1 需求 → S2 选型 → S3 上线 的有序流水线,每阶段有出口门、每步有退出条件。一个 `docs/进度账本.md` 记录"当前走到第几步",AI 每轮先读、每过一步回写,**没过门不准往下冲**,跳步要留痕。这解决了"纯 Skill 在对话里不按步骤推进、乱序跳步"的问题。详见 `docs/Harness-v2-重设计方案.md`。
  49. > **项目进度卡(v2.1 新增):** `docs/进度账本.md` 管 S1/S2/S3 流程门,`.dsu/progress/` 管开发期上下文恢复。默认只读 `.dsu/progress/index.md`,任务涉及某个模块时再读 `.dsu/progress/modules/duXX-xxx.md`,需要复盘单次任务时才读 `.dsu/progress/tasks/任务ID.md`。总表只放索引级信息:当前阶段、当前主线、完成 DU、进行中 DU、下一步、最大风险。模板见 `examples/项目进度卡-总表模板.md`、`examples/项目进度卡-模块模板.md`、`examples/项目进度卡-任务模板.md`。
  50. ### 📚 方法论库(references/方法论)
  51. Skill 不再把产品方法论抄在每个文件里,而是统一收进 `references/方法论/`——问题优先、RICE/MoSCoW 优先级、**EARS 验收格式**、边界清单、非功能模板、HEART 指标、用户研究全流程等。Skill 在你卡住时指向对应那份,**你不需要通读**。脾气照旧:方法论是工具箱不是检查表,demo 阶段一律打折,挑真用得上的几件。
  52. > **新增的两个行为**:① **分诊**——开问之前先判断需求"分量",简单需求轻问快走,复杂需求才深问("能自己推断的别问用户");② **推荐选项 clarify**——不再用开放式问题轰炸小白,而是先陈述理解、把默认假设做成 `[✓ 就这样] [换一个:…]` 的推荐项让你一眼确认。既不让你面对空白,也不替你闷头做主。
  53. ## 你的旅程
  54. <div align="center">
  55. <img src="assets/journey.png" alt="vibe-coding-kit 的使用旅程:从想法到上线,5 个 Skill 各管一段" width="900">
  56. </div>
  57. ## 不止于"做完"——把小白带成行家
  58. 大多数工具教你"怎么用 AI 把事办成"。这套件多走一步:**让你逐步看懂自己在做什么。**
  59. `architecture` 里的「6 个维度」和「把 AI 当老师」,不是让你照搬话术,而是让你学会**拷问任何方案**——数据存哪、谁在跑、依赖几何、值不值这个复杂度。用上几个项目,你会发现自己不再需要话术,因为你已经能一眼看穿方案的好坏。
  60. > 这才是它和"又一个 prompt 合集"的根本区别。
  61. ## 快速开始
  62. 每个 Skill 就是一个含 `SKILL.md` 的文件夹——这是通用的 Skill 格式。下面三种用法,**从最省事到最进阶**,挑一个适合你的:
  63. ### 方式一 · 零安装,复制即用(最简单,人人都会)★ 推荐先用这个
  64. 不想折腾任何设置,30 秒就能试:
  65. 1. 打开本仓库,进 `skills/` 里你想用的那个文件夹(不知道选哪个?先用 `vibe-coding-requirements`)。
  66. 2. 点开里面的 `SKILL.md`,**全选复制**全部内容。
  67. 3. 回到你和 AI 的对话框(Claude、ChatGPT、Codex 都行),**粘贴进去**,再补一句"请按上面这套方法帮我"。
  68. 就这样,立刻能用。先把它跑顺,确认有用了,再考虑下面更省心的方式。
  69. ### 方式二 · Claude 网页/桌面版:上传成自定义 Skill
  70. 如果你常用 [claude.ai](https://claude.ai) 网页版或桌面 App(需要 Pro 及以上套餐):
  71. 1. 先把整个仓库下载到本地:点页面右上角绿色 **Code → Download ZIP**,解压。
  72. 2. 在 Claude 里进入 **Settings(设置)→ Capabilities / Skills(技能)**。
  73. 3. 选择上传自定义 Skill,把 `skills/` 下你要用的那个文件夹(含 `SKILL.md`)传上去。
  74. 4. 之后在对话里它会**在合适的时机自动登场**,不用每次再贴。
  75. ### 方式三 · Claude Code:放进 skills 文件夹
  76. 如果你用命令行版的 Claude Code:
  77. ```bash
  78. # 1. 下载仓库
  79. git clone https://github.com/Junliu1066/vibe-coding-kit.git
  80. # 2. 把需要的 skill 复制到 Claude Code 的个人 skills 目录
  81. cp -R vibe-coding-kit/skills/vibe-coding-requirements ~/.claude/skills/
  82. # 想全装就把整个 skills 目录下的文件夹都复制过去
  83. ```
  84. 放好后重启 Claude Code,它会自动识别;你描述需求时对应 skill 会自动触发。
  85. > **说明:** 各端的菜单名称和入口可能随版本更新而微调,如与上文略有出入,请以官方最新文档为准:[docs.claude.com](https://docs.claude.com) ・ [support.claude.com](https://support.claude.com)。**拿不准就用「方式一」**,它永远有效。
  86. ## 先看一个真实案例
  87. [`examples/案例-竞品调研助手.md`](./examples/案例-竞品调研助手.md) 用一个完整项目——**竞品调研助手**——带你从一句话想法走到能用:
  88. - 五步选型法**实际砍掉了哪几个方案**,为什么
  89. - 6 个维度照出了这个项目真正的风险(提示:是 AI 接口的成本与密钥)
  90. - 哪些诱人的功能被"以后再说"清单挡在了门外
  91. - 红线自检如何判断"这事我能不能放心自己干"
  92. 强烈建议先读它,再上手自己的项目。
  93. ## 设计信条
  94. 这套件有脾气。它信奉:
  95. - **复杂度是负债,不是资产。** 每多一个组件、一个依赖,都是向未来借债。
  96. - **先说问题,再说方案。** 描述方案会锁死 AI,描述问题才有更优解。
  97. - **没有代价的方案不存在。** 不跟你讲代价的推荐,不可信。
  98. - **知道边界,也是本事。** 有些事(动钱、动别人隐私)该找真人——这不是认怂,是行家。
  99. - **维护成本是最终裁决。** 一年后你还修不修得动,比什么都重要。
  100. ## 适合谁
  101. - 不写代码、或刚起步,靠 AI 把想法变成产品的产品经理、创业者、独立开发者。
  102. - 想先跑个 demo 验证,又怕跑偏、怕烂尾的人。
  103. - 想借着每个项目,真正把技术判断力练出来的人。
  104. ## 参与共建
  105. 欢迎 Issue 和 PR:补充话术、修正不准的地方、贡献新的真实案例。改动时请守住这套件的脾气——**大白话、讲代价、不堆复杂度。**
  106. ## License
  107. [MIT](./LICENSE)。自由使用、修改、再分发。
  108. ---
  109. <div align="center">
  110. **少走弯路,是最被低估的生产力。**
  111. 如果它帮到了你,点个 ⭐ 让更多人少走弯路。
  112. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.