Ron-dali/vibe-coding-rules
GitHub: Ron-dali/vibe-coding-rules
该工具为 AI 编程提供了一套自生长的代码质量管道，通过规则约束、面包屑上下文记忆与自动化测试，解决了 AI 写代码时频繁失忆与代码回归的问题。
Stars: 3 | Forks: 0
# Vibe Coding 规则 V2.5
## 🤔 为什么需要这个？/ Why do you need this?
用 AI 写代码的人都会遇到 / 如果你用 AI 写代码，你就会懂这些痛：
| 痛点 / Pain | 表现 / Symptom |
|:--|:--|
| 🧠 **AI 失忆 / Amnesia** | 昨天修好的 Bug 今天原样重现。改 B 模块时破坏 A 模块。
昨天修好的 Bug？今天又回来了。修好模块 A，破坏了模块 B。 | | 🔁 **重复踩坑 / Repeat Mistakes** | 同样的错误（`\|\|` 吞 0、select 假选中）犯了又犯。
同样的陷阱（`\|\|` 吞掉 `0`、select 假选中）一再发生。 | | 📝 **改完不知道改了什么 / No Trace** | 没有变更记录，不知道动了哪些文件、影响了什么。
没有变更日志。我动了什么？我破坏了什么？ | | 🧪 **改完不知道坏了没有 / No Regression** | 改一行 CSS 导致整个页面挂了，手动回归太累。
改了一行 CSS → 整个页面崩溃。手动测试太累人。 | | 🗺️ **项目越大越迷路 / Lost in Code** | 打开一个文件，不知道它关联了谁、上次怎么改的。
打开一个文件。什么和它耦合了？它上次是怎么被修改的？ | **Vibe Coding Rules 解决了所有这些问题。** ## 🛠️ 6 个 Skill 怎么工作 / 6 个 Skill 如何运作 ``` ┌──────────────────────────────────────────┐ │ 🥇 coding-principles │ │ 改前自查 / Pre-code: 5 principles │ │ + 🍞 breadcrumb pre-scan │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🛡️ safe-terminal-executor │ │ 安全终端 / Safe terminal execution │ │ timeout + guaranteed exit │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🔍 self-check │ │ 改后自检 / Post-change: 28 rules │ │ + 🍞 breadcrumb auto-seeding │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🧪 web-testing │ │ 回归测试 / Regression: DOM+screen+OCR │ │ auto browser testing │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 📝 changelog │ │ 变更日志 / Changelog + growth detect │ │ what changed + what was learned │ └──────────────┬───────────────────────────┘ │ git commit ✅ Closed Loop ``` ### 🥇 coding-principles — 改前五大原则 / 编码前 5 大原则 | 原则 / Principle | 问什么 / 检查什么 | |:--|:--| | 🍞 **Breadcrumb Pre-scan** | 打开文件先看 🍞 头部——这个文件关联了谁？（V2.5）
先读 🍞 头部 —— 什么与这个文件耦合了？ | | 1️⃣ **Think First** | 我真的理解问题了吗？确定在改正确的文件？
我理解这个问题吗？我改对文件了吗？ | | 2️⃣ **Subtract First** | 能不能删代码解决？是不是在过度工程化？
删除代码能修复这个问题吗？我是否过度工程化了？ | | 3️⃣ **Surgical Change** | 只改必须改的，有没有碰了无关代码？
最小化变更。我碰了什么不相关的东西吗？ | | 4️⃣ **It Must Run** | 改完能跑吗？JS + CSS + Template 三端都检查了吗？
它能运行吗？JS + CSS + Template —— 都检查过了吗？ | +3 个常见陷阱自动拦截 / +3 个自动陷阱检测：`\|\|` 吞掉 `0` / select 假选中 / POST 硬编码字段 ### 🛡️ safe-terminal-executor — 安全终端 / 安全终端 你再也不会看到 AI 的 curl 请求卡住 5 分钟了。 ### 🔍 self-check — 改后 28 条自检 + 🍞 面包屑 / 改后 28 条规则检查 | 轨道 / Tier | 行为 / Behavior | 累积后 / Promotes at | |:--|:--|:--| | Tier 0 观察 | 仅记录不阻断 / 仅记录 | — | | Tier 1 软规则 | 警告，可放过 / 警告，可跳过 | 置信度 ≥ 3 | | Tier 2 硬规则 | 阻断，必须修 / 阻断，必须修复 | 置信度 ≥ 5 | **规则会自动生长**——今天踩的坑，明天变成 AI 不能再犯的硬规则。误报过多自动退役，全程不需要人审核。 **自生长规则** —— 今天的坑会成为明天的硬规则。误报自动退役。零人工审核。 #### 🍞 面包屑系统 — V2.5 的灵魂 这是整套工具的**灵魂机制**。改代码时 AI 会在文件头部自动播种"面包屑"： 这是整个工具包的**灵魂**。AI 会在文件头部自动植入面包屑： ``` ``` - **改前扫描 / Pre-scan**：AI 打开文件先读 🍞，知道耦合关系和历史坑位
AI 先读 🍞 头部 —— 了解耦合与过往陷阱 - **改后播种 / Post-seed**：改完自动更新 🍞，下次 AI 不再失忆
修改后自动更新 🍞 —— AI 再也不会忘记 - **四环闭环 / 4-Loop Closure**：改代码 → 自检 → 更新文档 → 播种面包屑 → 下次改代码时有完整地图
代码 → 检查 → 更新文档 → 植入面包屑 → 下次就有完整地图 ### 🧪 web-testing — 自动化回归测试 / 自动回归测试 | 检测方式 / Method | 做什么 / 它做什么 | |:--|:--| | DOM 断言 / DOM Assertion | 关键元素在不在？按钮能不能点？
关键元素存在吗？按钮可点击吗？ | | 截图对比 / Screenshot Diff | 跟上次截图比，布局有没有崩？
与上次截图相比布局崩坏了吗？ | | OCR 验证 / OCR Check | 页面上的文字对不对？
页面上的文字正确吗？ | 改一行 CSS 不会悄无声息地炸掉整个页面。 一行 CSS 不会悄无声息地摧毁你的整个页面。 ### 📝 changelog — 变更日志 + 生长检测 / 变更日志 + 生长检测 | 内容 / What | 说明 / Details | |:--|:--| | 改动概述 / Changes | 改了哪些文件、新增/删除行数
哪些文件，新增/删除了多少行 | | 新增依赖 / New Deps | 是不是加了新包
安装了新包吗？ | | 自检结果 / Self-Check | 28 条规则通过了多少
28 条规则 —— 通过了多少？ | | 生长事件 / Growth | 今天有规则从观察池晋升到硬规则了吗？
今天有规则从观察晋升为硬规则吗？ ### 🚀 pipeline-init — 一键初始化 / 一键引导 你说"我要做一个 XX 项目"，AI 问 4 个问题（项目名/技术栈/类型/要不要自动测试），一分钟搭好全部质量基础设施。 说“我想构建 X。”AI 问 4 个问题（名称/技术栈/类型/自动测试？）。一分钟。部署完整的基础质量设施。 ## 📦 安装 / 安装 ``` # Windows install.bat # macOS / Linux chmod +x install.sh && ./install.sh # PowerShell .\install.ps1 ``` 支持 **CodeBuddy / Cursor / Windsurf** 三种 AI Agent。 ## 🎯 谁需要这个？/ 这个是为谁准备的？ | 如果你 / If you | 你需要这个因为 / You need this because | |:--|:--| | 🐣 **用 AI 写代码但不懂编程 / AI-coder, non-programmer** | 这是你的"编程纪律外骨骼"，AI 不再瞎改
你的代码纪律外骨骼。AI 停止鲁莽的编辑。 | | 💻 **独立开发者 / 一人公司 / Solo dev** | 你是你自己的 QA，这 6 个 Skill 就是你的 QA 团队
你就是你自己的 QA。这 6 个 Skill 就是你的 QA 团队。 | | 🏢 **小型团队用 AI 辅助 / Small team + AI** | 统一代码质量标准，减少 Code Review 成本
统一的质量标准。降低 Code Review 成本。 | | 🤖 **重度 AI Agent 用户 / Heavy AI agent user** | 你的 Agent 越用越聪明——规则自生长，不遗忘
你的 Agent 会随着时间推移变得更聪明。规则在生长。没有东西被遗忘。 | ## 📖 作者的故事 / 作者的故事 **我不知道怎么写代码。一行都不会。** 45 天。纯靠 AI 写代码工具。从零开始构建了一个 **14 万行代码**、覆盖 3 大平台（Web + Desktop + MiniApp）的产品 —— [躺不平联盟 (TangBuPing)](https://tangbuping.com)，一个 AI 知识平权平台。 最大的痛点不是 AI 写不出代码。而是 **AI 会忘记它写过什么**。昨天修好的 Bug？今天又回来了。修好模块 A，毁了模块 B。 3 个月的战斗伤痕，浓缩成了这 6 个 Skill。开源出来，这样你就不用流同样的血。 **躺不平不是卷，是让其他人也躺不平。** *我们没有更拼命地内卷。我们只是让其他人也没法继续躺平。* ## 🔗 链接 / 链接 - 🏠 [躺不平联盟](https://tangbuping.com) - 🐙 [GitHub Profile](https://github.com/Ron-dali) ## 📄 许可 / 许可证 Apache 2.0 — Free to use, modify, distribute. 自由使用、修改、分发。
昨天修好的 Bug？今天又回来了。修好模块 A，破坏了模块 B。 | | 🔁 **重复踩坑 / Repeat Mistakes** | 同样的错误（`\|\|` 吞 0、select 假选中）犯了又犯。
同样的陷阱（`\|\|` 吞掉 `0`、select 假选中）一再发生。 | | 📝 **改完不知道改了什么 / No Trace** | 没有变更记录，不知道动了哪些文件、影响了什么。
没有变更日志。我动了什么？我破坏了什么？ | | 🧪 **改完不知道坏了没有 / No Regression** | 改一行 CSS 导致整个页面挂了，手动回归太累。
改了一行 CSS → 整个页面崩溃。手动测试太累人。 | | 🗺️ **项目越大越迷路 / Lost in Code** | 打开一个文件，不知道它关联了谁、上次怎么改的。
打开一个文件。什么和它耦合了？它上次是怎么被修改的？ | **Vibe Coding Rules 解决了所有这些问题。** ## 🛠️ 6 个 Skill 怎么工作 / 6 个 Skill 如何运作 ``` ┌──────────────────────────────────────────┐ │ 🥇 coding-principles │ │ 改前自查 / Pre-code: 5 principles │ │ + 🍞 breadcrumb pre-scan │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🛡️ safe-terminal-executor │ │ 安全终端 / Safe terminal execution │ │ timeout + guaranteed exit │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🔍 self-check │ │ 改后自检 / Post-change: 28 rules │ │ + 🍞 breadcrumb auto-seeding │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 🧪 web-testing │ │ 回归测试 / Regression: DOM+screen+OCR │ │ auto browser testing │ └──────────────┬───────────────────────────┘ │ ┌──────────────▼───────────────────────────┐ │ 📝 changelog │ │ 变更日志 / Changelog + growth detect │ │ what changed + what was learned │ └──────────────┬───────────────────────────┘ │ git commit ✅ Closed Loop ``` ### 🥇 coding-principles — 改前五大原则 / 编码前 5 大原则 | 原则 / Principle | 问什么 / 检查什么 | |:--|:--| | 🍞 **Breadcrumb Pre-scan** | 打开文件先看 🍞 头部——这个文件关联了谁？（V2.5）
先读 🍞 头部 —— 什么与这个文件耦合了？ | | 1️⃣ **Think First** | 我真的理解问题了吗？确定在改正确的文件？
我理解这个问题吗？我改对文件了吗？ | | 2️⃣ **Subtract First** | 能不能删代码解决？是不是在过度工程化？
删除代码能修复这个问题吗？我是否过度工程化了？ | | 3️⃣ **Surgical Change** | 只改必须改的，有没有碰了无关代码？
最小化变更。我碰了什么不相关的东西吗？ | | 4️⃣ **It Must Run** | 改完能跑吗？JS + CSS + Template 三端都检查了吗？
它能运行吗？JS + CSS + Template —— 都检查过了吗？ | +3 个常见陷阱自动拦截 / +3 个自动陷阱检测：`\|\|` 吞掉 `0` / select 假选中 / POST 硬编码字段 ### 🛡️ safe-terminal-executor — 安全终端 / 安全终端 你再也不会看到 AI 的 curl 请求卡住 5 分钟了。 ### 🔍 self-check — 改后 28 条自检 + 🍞 面包屑 / 改后 28 条规则检查 | 轨道 / Tier | 行为 / Behavior | 累积后 / Promotes at | |:--|:--|:--| | Tier 0 观察 | 仅记录不阻断 / 仅记录 | — | | Tier 1 软规则 | 警告，可放过 / 警告，可跳过 | 置信度 ≥ 3 | | Tier 2 硬规则 | 阻断，必须修 / 阻断，必须修复 | 置信度 ≥ 5 | **规则会自动生长**——今天踩的坑，明天变成 AI 不能再犯的硬规则。误报过多自动退役，全程不需要人审核。 **自生长规则** —— 今天的坑会成为明天的硬规则。误报自动退役。零人工审核。 #### 🍞 面包屑系统 — V2.5 的灵魂 这是整套工具的**灵魂机制**。改代码时 AI 会在文件头部自动播种"面包屑"： 这是整个工具包的**灵魂**。AI 会在文件头部自动植入面包屑： ``` ``` - **改前扫描 / Pre-scan**：AI 打开文件先读 🍞，知道耦合关系和历史坑位
AI 先读 🍞 头部 —— 了解耦合与过往陷阱 - **改后播种 / Post-seed**：改完自动更新 🍞，下次 AI 不再失忆
修改后自动更新 🍞 —— AI 再也不会忘记 - **四环闭环 / 4-Loop Closure**：改代码 → 自检 → 更新文档 → 播种面包屑 → 下次改代码时有完整地图
代码 → 检查 → 更新文档 → 植入面包屑 → 下次就有完整地图 ### 🧪 web-testing — 自动化回归测试 / 自动回归测试 | 检测方式 / Method | 做什么 / 它做什么 | |:--|:--| | DOM 断言 / DOM Assertion | 关键元素在不在？按钮能不能点？
关键元素存在吗？按钮可点击吗？ | | 截图对比 / Screenshot Diff | 跟上次截图比，布局有没有崩？
与上次截图相比布局崩坏了吗？ | | OCR 验证 / OCR Check | 页面上的文字对不对？
页面上的文字正确吗？ | 改一行 CSS 不会悄无声息地炸掉整个页面。 一行 CSS 不会悄无声息地摧毁你的整个页面。 ### 📝 changelog — 变更日志 + 生长检测 / 变更日志 + 生长检测 | 内容 / What | 说明 / Details | |:--|:--| | 改动概述 / Changes | 改了哪些文件、新增/删除行数
哪些文件，新增/删除了多少行 | | 新增依赖 / New Deps | 是不是加了新包
安装了新包吗？ | | 自检结果 / Self-Check | 28 条规则通过了多少
28 条规则 —— 通过了多少？ | | 生长事件 / Growth | 今天有规则从观察池晋升到硬规则了吗？
今天有规则从观察晋升为硬规则吗？ ### 🚀 pipeline-init — 一键初始化 / 一键引导 你说"我要做一个 XX 项目"，AI 问 4 个问题（项目名/技术栈/类型/要不要自动测试），一分钟搭好全部质量基础设施。 说“我想构建 X。”AI 问 4 个问题（名称/技术栈/类型/自动测试？）。一分钟。部署完整的基础质量设施。 ## 📦 安装 / 安装 ``` # Windows install.bat # macOS / Linux chmod +x install.sh && ./install.sh # PowerShell .\install.ps1 ``` 支持 **CodeBuddy / Cursor / Windsurf** 三种 AI Agent。 ## 🎯 谁需要这个？/ 这个是为谁准备的？ | 如果你 / If you | 你需要这个因为 / You need this because | |:--|:--| | 🐣 **用 AI 写代码但不懂编程 / AI-coder, non-programmer** | 这是你的"编程纪律外骨骼"，AI 不再瞎改
你的代码纪律外骨骼。AI 停止鲁莽的编辑。 | | 💻 **独立开发者 / 一人公司 / Solo dev** | 你是你自己的 QA，这 6 个 Skill 就是你的 QA 团队
你就是你自己的 QA。这 6 个 Skill 就是你的 QA 团队。 | | 🏢 **小型团队用 AI 辅助 / Small team + AI** | 统一代码质量标准，减少 Code Review 成本
统一的质量标准。降低 Code Review 成本。 | | 🤖 **重度 AI Agent 用户 / Heavy AI agent user** | 你的 Agent 越用越聪明——规则自生长，不遗忘
你的 Agent 会随着时间推移变得更聪明。规则在生长。没有东西被遗忘。 | ## 📖 作者的故事 / 作者的故事 **我不知道怎么写代码。一行都不会。** 45 天。纯靠 AI 写代码工具。从零开始构建了一个 **14 万行代码**、覆盖 3 大平台（Web + Desktop + MiniApp）的产品 —— [躺不平联盟 (TangBuPing)](https://tangbuping.com)，一个 AI 知识平权平台。 最大的痛点不是 AI 写不出代码。而是 **AI 会忘记它写过什么**。昨天修好的 Bug？今天又回来了。修好模块 A，毁了模块 B。 3 个月的战斗伤痕，浓缩成了这 6 个 Skill。开源出来，这样你就不用流同样的血。 **躺不平不是卷，是让其他人也躺不平。** *我们没有更拼命地内卷。我们只是让其他人也没法继续躺平。* ## 🔗 链接 / 链接 - 🏠 [躺不平联盟](https://tangbuping.com) - 🐙 [GitHub Profile](https://github.com/Ron-dali) ## 📄 许可 / 许可证 Apache 2.0 — Free to use, modify, distribute. 自由使用、修改、分发。
标签：AI合规, AI编程, Cutter, Libemu, 变更追踪, 工程规范, 开发辅助