AGENTS.md 和 config.yaml

在 OpenSpec 这类 SDD 框架里，AGENTS.md 和 config.yaml 的定位有本质区别：AGENTS.md 是面向通用 AI Agent 的行为准则，而 config.yaml 是专属于 OpenSpec 工作流的项目配置。两者可以共存，但职责边界清晰。

AGENTS.md：通用的 Agent “行为说明书”
它回答的是“AI 该如何工作”这类跨工具、跨任务的问题。内容通常包括 Agent 的角色设定、沟通风格、审批规则、提交规范等。它被各类 AI 编程工具读取，不限于 OpenSpec。

config.yaml：OpenSpec 专属的 “项目 DNA”
它回答的是“AI 该如何为这个项目规划变更”这类工作流内的问题。它只被 OpenSpec 的 openspec instructions 命令消费，用于生成 proposal、spec、design、tasks 等工件。

config.yaml 是 OpenSpec 专属的“规划配置”。它只被 OpenSpec 的工作流消费，其中的 context 字段会被注入到 OpenSpec 生成的每一个工件（proposal、spec、tasks）的提示词中。它的目标是让 AI 在执行 OpenSpec 工作流时，按照你的项目约定来规划变更。

因为 OpenSpec 的 config.yaml 需要一个“项目背景”字段（context），而根目录 AGENTS.md 从通用标准的角度也包含技术栈、架构描述。

根目录 AGENTS.md 是给“所有 AI 工具”看的项目说明书，config.yaml 是给“OpenSpec 工作流”看的规划配置。技术栈信息在两者中存在是合理的，但理想状态下，config.yaml 应该引用而非复制 AGENTS.md 的内容。例如写："See AGENTS.md for full tech stack and architecture overview."，这样既保持了单一事实来源，又让 OpenSpec 工作流知道去哪里找背景信息。

秋日生活打卡季