xiaoYshanzai的博客

维度轨道 A：AGENTS.md / Project Rules轨道 B：开发文档 (Specs)选择逻辑二选一 (Mutually Exclusive)多份并存 (One per feature)生命周期长期有效，极少变动短期有效，随任务迭代关注点形式 (Form)：代码风格、最佳实践内容 (Content)：业务规则、用户需求定位公司的《员工手册》具体的《任务工单》

从上面三个案例可以看出，面向文档驱动开发中的“用户故事”，实际上是自然语言编写的程序逻辑。写好这种文档的秘诀在于“C-I-R” 原则明确数据类型、大小限制、精度要求（如：别用 Float，最大 2MB）。明确 API 接收什么参数，报错时返回什么状态码（如：409 Conflict, 201 Created）。明确步骤的先后顺序（如：先校验数据库，再 Hash 密码，最后存库）。

自然语言虽然强大，但容易产生歧义。在关键环节，使用机器可读性更高的方式来锁定一致性。在文档中直接定义数据模型的类型和结构。id: string;// UUID// 待办事项内容// 是否完成// 创建时间在文档中定义函数的输入、输出和签名。效果： 当AI遵循这些强类型定义生成代码时，其生成结果的函数签名、数据处理逻辑将具有高度的一致性，减少了自然语言理解的偏差。

开发者不直接编写业务代码，而是通过编写详细的需求文档、接口定义、数据结构和伪代码，指挥 AI 完成代码实现的开发模式。需求 -> 人脑思考 -> 手写代码 -> 测试。需求 ->结构化文档（Markdown/Spec）-> AI 阅读文档 -> AI 生成代码 -> 人工Review与测试。“面向文档驱动开发”本质上是一次抽象层级的提升。计算机科学的历史就是一部抽象层级不断提升的历史：从 0101 到汇编，从汇编到高级语言（C/Java），现在是从高级语言到了自然语言描述的逻辑文档。在这个新时代，