核心设计理念¶

Vibe Coding 的六大设计原则，每一条都有可操作的实践含义。

原则一：规格优先于实现¶

理念：先固定"做什么"，再让 AI 决定"怎么做"。

实践含义：每次任务开始前，写一个包含目标、范围、约束和验证方式的规格文档，哪怕只有 5 行。没有规格的请求会导致 AI 过度发挥或缺乏约束。

错误方式：帮我优化这段代码
正确方式：把这个函数的时间复杂度从 O(n²) 降到 O(n log n)，
          只改算法逻辑，不改 API 接口，保持现有测试全部通过

理念：只提供当前任务真正需要的上下文，不多也不少。

实践含义：不要把整个代码库都扔给 AI。识别出当前任务的最小相关文件集，精准提供。

理念：AI 生成的代码是假设，验证是证明。

实践含义：每次任务完成后，必须经过测试、类型检查、构建和手动验收中的至少一项才算交付。完整的验证流程见验证闭环。

理念：小步迭代比大改一次更容易验证和回滚。

实践含义：把大任务拆成 3–5 个独立的小任务，每个小任务都能独立验证。避免一次性让 AI 改动超过 3 个文件。

理念：AI 生成错误结果时，不要重试同样的请求。

实践含义：当 AI 第一次失败，分析失败原因再重试。当 AI 两次失败，停下来复盘，根因可能在规格或上下文，而不在 AI 本身。

理念：个人经验应该变成团队资产。

实践含义：每次任务后记录有效的提示词模式、失败模式、项目特定约定。这些沉淀会让团队每次协作都比上次更高效。

原则之间的关系

这六条原则相互加强：规格优先让上下文更精准；最小上下文让验证更聚焦；验证闭环让增量交付更安全；每次失败都是改进规格的机会；所有经验最终沉淀为可复用知识。