前言¶
用 AI 改代码时，常见挫败不是「写不出来」，而是「写过又忘」：昨天刚修掉的边界条件，今天换一轮对话又原样踩坑；关联文件、历史坑位和设计文档散落在别处，Agent 每次打开文件都像第一次见。
单靠提示词里反复强调「要小心」「要记住上下文」，很难形成稳定闭环。下面介绍 SkillHub 上的 Vibe Coding Rules · AI编程纪律（坐标 @org-121tp3g2/vibe-coding-rules）：官方将其定位为 V2.5 的「编程纪律外骨骼」，用 6 个可自我进化的 Skill 串成改前自查、安全执行、改后扫描、自动化回归与变更归档的流水线，并辅以文件头面包屑与规则自生长机制。
这是什么¶
Vibe Coding Rules 是一套面向 AI 编程 Agent 的 Skill 组合，发布方为云南躺不平网络科技有限公司，在 SkillHub 分类为 dev-programming，当前包版本为 v1.0.0（页面简介中的 V2.5 指产品代际描述）。requires_api_key=false，无需额外 API Key。
它要解决的核心问题可以概括为：降低 Agent 在无状态对话下的重复犯错与上下文失忆，把纪律从「口头约定」变成可自动触发的步骤。
核心功能¶
以下能力均来自 SkillHub 官方简介，按流水线顺序说明。
六段闭环流水线¶
官方描述为 6 个自我进化的 Skill 组成一条龙，各步自动触发、形成闭环：
- 改前五大原则自查：在动代码前先做原则级检查。
- 终端安全执行：约束或规范终端侧执行方式（与安全执行相关的能力由 Skill 内规则承载）。
- 改后 28 条规则逐项扫描：提交改动后按 28 条规则做扫描，而不是依赖人工回忆 checklist。
- Playwright 自动化回归测试：接入 Playwright 做自动化回归。
- 变更日志自动归档：变更记录自动归档，便于追溯。
（简介将上述环节与「零人工串联」的闭环一并说明；具体子 Skill 名称与规则条文以安装包内 SKILL.md 及附属文件为准。）
面包屑系统¶
每次改代码时，在文件头部自动写入导航类标记，指向例如：耦合文件位置、历史坑位、设计文档链接等。下次 Agent 再打开同一文件时，可从头部标记快速恢复上下文，减轻「跨会话失忆」。
规则自生长¶
同一类 Bug 若重复出现达到官方描述的阈值（3 次），可自动升级为硬规则，后续 Agent 不得再违反该条。规则集随项目使用而累积，属于「越用越严」的纪律层，而非静态提示词。
兼容与许可¶
- 支持 CodeBuddy / Cursor / Windsurf 等 Agent 环境（安装到对应 Agent 的 skills 目录即可被识别）。
- Apache 2.0 开源，可免费商用。
安装与启用¶
Skill 基于通用 SKILL.md 格式。官方提供两条等价路径：用 SkillHub CLI 安装，或把安装提示词交给当前 Agent 执行。
方式一：SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录；否则默认落到 ./skills/，Agent 可能无法加载。Cursor 常用路径示例：
skillhub install org-121tp3g2/vibe-coding-rules --dir ~/.cursor/skills/
Windsurf 可参考官方路径：~/.codeium/windsurf/skills/ 或项目下的 .windsurf/skills/。其他 Agent 目录以 SkillHub 安装说明 第四节为准。
安装后按你所用 Client 的要求重启或刷新 Agent，使 skills 目录生效。
方式二：让 Agent 按文档安装¶
SkillHub 页面给出的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-121tp3g2/vibe-coding-rules`。
将上述内容发给当前编程 Agent，由其按 skillhub.md 完成 CLI 检查、--dir 安装与目录核对。
典型用法¶
官方未单独给出业务代码示例；可复现的「用法」即是让流水线在每次改码时自动跑通：
- 在 Cursor / Windsurf / CodeBuddy 中启用已安装的
@org-121tp3g2/vibe-coding-rules。 - 发起正常的改码任务（修 Bug、加功能、重构等），由 Skill 在改前触发五大原则自查，在执行阶段走终端安全策略，改后触发 28 条规则扫描。
- 需要回归时，由流水线中的 Playwright 环节承担自动化测试；完成后变更进入自动归档。
- 观察被改文件的头部是否出现面包屑标记；跨会话再次打开同一文件，确认 Agent 能读到耦合文件与文档指针。
- 若某类错误多次重复，关注是否按「三次升级硬规则」机制写入纪律层（具体触发与展示以包内规则实现为准）。
Playwright 与项目测试环境需在本机或 CI 中已具备相应依赖；Skill 描述的是接入点与纪律流程，不替代你项目自身的测试配置。
适用场景与注意¶
适合谁
- 长期用 Agent 维护同一仓库，且受困于重复 Bug、上下文断裂、改完无扫描无归档的团队或个人。
- 希望在 Cursor、Windsurf、CodeBuddy 上统一一套「改码纪律」，而不是每次手写超长 system prompt。
限制与注意
- SkillHub 元数据为 v1.0.0，与简介中的 V2.5 并存时，以安装包实际内容与
SKILL.md为准核对规则条数与子 Skill 划分。 - 流水线含 Playwright 回归：无浏览器测试基础或环境受限时，需自行评估该环节是否可运行。
- 规则自生长依赖历史重复模式识别，阈值以官方「3 次」描述为准；是否覆盖你项目的全部缺陷类型，需在实际仓库中验证。
- 安装务必使用正确的
--dir；装错目录是 Agent「装了却不用」的常见原因。
结尾¶
Vibe Coding Rules · AI编程纪律 把改前自查、安全执行、改后 28 条扫描、Playwright 回归与变更归档串成自动闭环，并用文件头面包屑与可升级硬规则缓解 Agent 失忆与重复犯错。若你在 SkillHub 检索编程类 Skill，可在页面查看评分与下载量（截至资料抓取时：评分 100000，下载 1435 次）。
