1236 字
约 4 分钟
10
规则的价值:14 章全景图、三步装进项目与适配四步(xs_vibe_rules 收官)
开场:每条规则解决一个真实问题
14 个章节走完了。这套规则的来源只有一个:**每发现一次 AI 反复犯的错误,就加一条规则。**收官这节把全景图摊开,再用一个自查流程帮你把它改造成你自己的。
一句话速览:14 章归入五大板块;三步装进项目;删、换、调、补适配成自己的规则。
一、14 章规则全景图:五大板块
🧭 流程控制(2 章)—— 断点设在编码前
- 需求处理与开发流程: 复述、PRD、等确认,再编码;修改超过 3 个文件先列计划(本专题第 2 节)
- PlayGround 组件页: 组件先进「试衣间」单独调好,再集成进正式页面(第 3 节)
🧱 质量底线(3 章)—— 完整实现,不接受将就
- 注释与代码保护: 三要素注释 + 禁止静默删除(第 4 节)
- 调试铁律: 先 Log 再改码,禁止猜测性修复(第 5 节)
- 完整实现: 不接受分期交付,技术债零容忍(第 6 节)
📚 文档沉淀(2 章)—— 决策跨对话留存
- 四份文档: FEATURES / CHANGELOG / RELEASE_NOTES / METHODOLOGY(第 7 节)
🔐 环境与安全(4 章)—— 环境事实一次写死
- 环境事实: 模型配置、技术栈锁定、必踩的坑写进 Rule(第 8 节)
- 三道闸: 备份、回退方案、发版 diff 审查(第 9 节)
✍️ 沟通与写作(3 章)—— 锚定与自查
- 长对话锚定: 超 10 轮强制复述目标与约束(第 10 节)
- 写作规范: 违禁句式清单消灭 AI 腔(第 10 节)
- 收官: 全景图与适配方法(第 11 节)
共同底层:把模糊期望变成可执行的具体动作。「注意质量」执行不了,「删除代码前必须显式声明」才执行得了。
二、使用方法 · 三步装进项目
STEP 1 · 放入 rules 目录: 把 .mdc 文件放进项目的 .cursor/rules/ 目录,Cursor 会自动识别。
STEP 2 · 配置生效方式: frontmatter 里的 alwaysApply 设 true 全局生效,设 false 则需手动 @ 引用,写作规范适合后者。
STEP 3 · 替换环境事实: 把模型配置、技术栈、端口规则换成你自己的选型,secrets 文件填占位符并排除出 git。
三、适配四步:删、换、调、补
这套规则并非拿来即用的模板。按四个动作适配:
- 删: 用不到的章节直接删。比如你不做中文内容创作,第十四章写作规范就可以去掉。
- 换: 把环境事实换成你的:模型、技术栈、端口、代理、数据库。
- 调: 阈值按项目调:3 个文件的批量断点,谨慎项目调成 1,快速原型放宽到 5。
- 补: 用满一周后,把新踩的坑写成新规则补进去,把从没生效的删掉。
四、11 节课一句话回顾
- Rule 注入: 约束靠不靠得住,看注入机制。
- 需求四步: 复述、PRD、许可,断点设在动手前。
- PlayGround: 新组件先试衣,老样式再收敛。
- 注释与删除: 三要素写得出,保护规则删不掉。
- 先 Log 再改码: 证据先行,禁止猜测性修复。
- 完整实现: 不接受分期,技术债的后续永远不会来。
- 文档沉淀: 四份文档各管一个维度,决策跨对话存活。
- 环境事实: 一次写死,轮轮生效。
- 三道闸: 备份、回退、diff 审查,都设在执行前。
- 锚定与写作: 锚定对抗遗忘,清单对抗含糊。
- 收官: AI 负责快,规则负责稳。
五、结课作业:发布你的第一版 Rules
60 分钟 · 提交物:你自己的 rules 仓库。从 xs_vibe_rules 出发,按删、换、调、补四个动作产出你的第一版规则文件;在一个真实项目里用满一周,记录哪些规则被触发、哪些从没生效;删掉从没生效的,把新踩的坑写成新规则,然后开源你的版本。
Takeaway
**AI 负责快,规则负责稳。**规则的价值不在于多,每条都解决一个真实问题。照搬 14 章不如精选 5 章,规则和代码一样,没人维护就会腐烂。
拿走这套规则: 开源仓库 itshen/xs_vibe_rules(MIT License)——本专题的起点。Fork 一份,按删、换、调、补改成你自己的版本,用满一周后开源出来。
规则的价值:14 章全景图、三步装进项目与适配四步(xs_vibe_rules 收官)
https://clxhxhhr.top/posts/4650/ 评论
0 条
还没有评论,先写一条吧。