docs: add machine gates to vibe coding roles

This commit is contained in:
tukuaiai
2026-05-01 22:23:13 +08:00
parent b383d4ce05
commit ac2b462930
@@ -10,6 +10,8 @@ Vibe Coding 不是把代码外包给 AI,也不是让 AI 随机试错。
它是一套工程协作方式:人负责目标、约束、判断与验收;AI 负责读取上下文、提出计划、修改文件、运行命令与整理证据。
关键原则:**AI 不能自证正确**。凡是能被测试、类型、schema、lint、CI、脚本或代码断言校验的规则,都应变成机器门禁,而不是只写在提示词里。
## 四层能力
**一:连接**
@@ -35,6 +37,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git;你负责确认
- 说清目标:要做什么、不要做什么、成功标准是什么
- 设定约束:技术栈、时间、成本、风险、边界
- 做最终判断:方案是否合理、结果是否可接受
- 设置门禁:把验收标准转成测试、CI、脚本、类型、schema 或检查清单
**AI 负责:**
@@ -43,6 +46,13 @@ AI 能安装依赖、执行命令、修复报错、提交 Git;你负责确认
- 执行动作:写代码、改文档、跑命令、查问题
- 沉淀证据:测试结果、diff、commit、风险说明
**机器门禁负责:**
- 拦截幻觉:依赖不存在、路径错误、命令不可执行、链接失效、配置字段不匹配时直接失败
- 拦截糊弄:没有测试、没有 lint、没有类型检查、没有验收证据时不允许合并
- 拦截越界:不符合 AGENTS、schema、接口契约、目录规范或安全规则的改动直接报错
- 强制分发:把规范分发到 CI、pre-commit、脚本、模板、类型系统、单元测试和集成测试里,让规则自动执行
## 入门铁律
1. 先定义问题,再让 AI 写代码。
@@ -50,6 +60,9 @@ AI 能安装依赖、执行命令、修复报错、提交 Git;你负责确认
3. 每一步都要能验证,不把“看起来对”当成完成。
4. 频繁提交 Git,把每次进展变成可回滚的检查点。
5. 让 README、AGENTS、任务文档持续更新,避免上下文丢失。
6. 不相信 AI 的口头保证,只相信可复现命令、测试输出、CI 状态和可审查 diff。
7. 重要规范必须代码化:能写成 lint、test、schema、type、hook、CI 的,就不要只写成自然语言。
8. 不符合规范的产出必须失败,而不是靠人记住提醒 AI。
---