diff --git a/assets/documents/guides/getting-started/Vibe Coding 哲学原理.md b/assets/documents/guides/getting-started/Vibe Coding 哲学原理.md index 40c7e7b..92fadee 100644 --- a/assets/documents/guides/getting-started/Vibe Coding 哲学原理.md +++ b/assets/documents/guides/getting-started/Vibe Coding 哲学原理.md @@ -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。 ---