AI-DLC阶段定义格式速览YAML Frontmatter与三段式Body完全指南【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflowsAI-DLC 阶段定义格式Stage Definition Format是理解 AI-DLCAI-Driven Life CycleAI 驱动生命周期工作流引擎的第一把钥匙。每个阶段就是一个带 YAML Frontmatter 的 Markdown 文件——上半部分告诉引擎这个阶段依赖谁、产出什么、谁来执行下半部分告诉AI 代理具体怎么干活。本文带你快速看懂这套阶段文件结构无需阅读大量源码。 阶段文件是什么一个文件两种读者一个阶段文件例如 scope-definition.md同时服务于两个互不重叠的读者读者读什么忽略什么解析器parseStageFrontmatterYAML Frontmatter生成结构化的图节点正文执行阶段的 LLM 代理正文指令产出工件Frontmatter把两者放在同一个文件里是有意的设计审代码时你能同时看到依赖边和执行步骤评审体验极佳。改 Frontmatter 是改图依赖、代理、执行方式改 Body 是改工作代理实际做的事——两者相互独立。完整契约见 stage-definition.md叙事版讲解见 15-stage-definition.md。 Frontmatter 字段速查改之前先搞懂这些Frontmatter 是一组扁平的 YAML 键其中真正需要判断力的字段如下字段决定了什么新手判断要点slug/phase阶段身份kebab-case且必须与文件名一致phase取initialization、ideation、inception、construction、operation之一execution/condition是否执行ALWAYS无条件执行CONDITIONAL配合自由文本说明分支条件lead_agent/support_agents谁来执行一个主代理拥有该阶段支持代理补充视角取值动态校验.md代理文件无硬编码枚举mode通信拓扑见下节详解requires_stage依赖与排序边既表达我要读你的产出也表达我要排在你后面produces/consumes工件的出边与入边依赖图不是手写的而是由所有阶段的这两组声明涌现出来的for_each是否按实例迭代如 Construction 的 5 个阶段声明for_each: unit-of-work对每个 Unit 各跑一次scopes在哪些工作范围内执行列出即该范围下 EXECUTE未列出即 SKIPconsumes 的两个易错点required: true是作用域内的语义表示如果上游阶段在当前计划里运行这个输入必须满足而不是该工件永远存在。bugfix等范围会跳过上游阶段此时相关 consume 自动失效。conditional_on: brownfield表达棕地/绿地差异。无条件 consume 直接省略该字段——不存在always值。mode四种通信拓扑mode决定 Body 执行期间谁和谁说话inline—— 指挥者在自身上下文中兼任所有角色零派发适合短阶段subagent—— 中枢-辐条把主代理派发到全新上下文适合代码生成这类长阶段pipeline—— 链式接力支持代理按声明顺序依次增强草案mob—— 网状协作支持代理并行贡献附带一轮有界的异议确认。质量门控字段reviewerreview_artifactreviewer_max_iterations默认 2在工件产出后、人工批准门前插入独立质量评审summary_confirmation: required生成工件前必须先让用户确认澄清问题汇总Looks correct回执防止 AI 自问自答直接产出。✍️ 三段式 BodySteps / Sensors / LearnFrontmatter 之下Body 固定按顺序包含三个分区分区状态放什么## Steps必填且必须有内容代理要执行的祈使句步骤加载上下文、生成问题清单、产出工件、呈现批准门## Sensors已填充简洁的传感器摘要输出位置、Imports:行镜像 frontmatter 的sensors:、Upstream targets:行## Learn已填充指向 stage-protocol.md §13 学习循环契约的简洁指针工作时维护memory.md日记在人工门前持久化已确认的经验三段式分区是预先声明的v0.3.0 只填了## Stepsv0.5.0 补充## Sensors和## Learn时只是插槽式填入无需重构正文。可以对照 domain-design.md 查看三段齐全的真实示例。有一条边界值得记住阶段文件是框架产物形状不可变——工作流运行期间不会重写## Steps/## Sensors/## Learn结构。你在文件里改的每一处都应该是作为框架工程师的刻意修改。⚙️ YAML 是唯一事实源stage-graph.json 绝不手改这是新手最容易踩的坑编辑阶段 .md 的 YAML → 编译 → stage-graph.json → 运行时读取所有阶段文件的 YAML Frontmatter 是权威来源stage-graph.json是编译产物构建输出由 aidlc-graph.ts 生成compile --check会在内存中重编译并比对JSON 与 YAML 不一致即构建失败。所以规则只有一条改 YAML然后重新编译绝不手改 JSON。手改要么被下次编译覆盖要么触发漂移检查。编译后生成的图包含计算字段display_order由requires_stage拓扑排序得出它不写在 YAML 里也不需要写。另一个重要约定阶段文件不硬编码工件路径根。produces[]只声明工件名字引擎在执行时把名字解析到当前意图的记录目录下见 15-stage-definition.md 的 Artifact paths are engine-resolved 一节。在outputs:里写死工作区根路径属于文档错误而非行为契约。✅ 新手清单正确读写一个阶段文件新写阶段复制 scope-definition.md 作模板它是官方可直接复制粘贴的范例改依赖同步更新requires_stage、consumes、produces三组列表并保留inputs:/outputs:的人话描述与图声明一致改执行只动mode、lead_agent、support_agents注意pipeline/mob要求support_agents非空加评审声明reviewer时必须同时给review_artifact且它必须是produces[]中的一个必填 Markdown 工件校验阶段字段约束由 aidlc-stage-schema.ts 定义未知键会被 schema 拒绝——预留字段when、on_failure、blocks_on等有专门命名空间不要自己发明新键。延伸阅读Anatomy of a Stage 从阶段是工作流原子的角度带你完整走一遍Adding a Stage 则手把手教你从零接入一个新阶段。【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflows创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AI-DLC阶段定义格式速览：YAML Frontmatter与三段式Body完全指南
AI-DLC阶段定义格式速览YAML Frontmatter与三段式Body完全指南【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflowsAI-DLC 阶段定义格式Stage Definition Format是理解 AI-DLCAI-Driven Life CycleAI 驱动生命周期工作流引擎的第一把钥匙。每个阶段就是一个带 YAML Frontmatter 的 Markdown 文件——上半部分告诉引擎这个阶段依赖谁、产出什么、谁来执行下半部分告诉AI 代理具体怎么干活。本文带你快速看懂这套阶段文件结构无需阅读大量源码。 阶段文件是什么一个文件两种读者一个阶段文件例如 scope-definition.md同时服务于两个互不重叠的读者读者读什么忽略什么解析器parseStageFrontmatterYAML Frontmatter生成结构化的图节点正文执行阶段的 LLM 代理正文指令产出工件Frontmatter把两者放在同一个文件里是有意的设计审代码时你能同时看到依赖边和执行步骤评审体验极佳。改 Frontmatter 是改图依赖、代理、执行方式改 Body 是改工作代理实际做的事——两者相互独立。完整契约见 stage-definition.md叙事版讲解见 15-stage-definition.md。 Frontmatter 字段速查改之前先搞懂这些Frontmatter 是一组扁平的 YAML 键其中真正需要判断力的字段如下字段决定了什么新手判断要点slug/phase阶段身份kebab-case且必须与文件名一致phase取initialization、ideation、inception、construction、operation之一execution/condition是否执行ALWAYS无条件执行CONDITIONAL配合自由文本说明分支条件lead_agent/support_agents谁来执行一个主代理拥有该阶段支持代理补充视角取值动态校验.md代理文件无硬编码枚举mode通信拓扑见下节详解requires_stage依赖与排序边既表达我要读你的产出也表达我要排在你后面produces/consumes工件的出边与入边依赖图不是手写的而是由所有阶段的这两组声明涌现出来的for_each是否按实例迭代如 Construction 的 5 个阶段声明for_each: unit-of-work对每个 Unit 各跑一次scopes在哪些工作范围内执行列出即该范围下 EXECUTE未列出即 SKIPconsumes 的两个易错点required: true是作用域内的语义表示如果上游阶段在当前计划里运行这个输入必须满足而不是该工件永远存在。bugfix等范围会跳过上游阶段此时相关 consume 自动失效。conditional_on: brownfield表达棕地/绿地差异。无条件 consume 直接省略该字段——不存在always值。mode四种通信拓扑mode决定 Body 执行期间谁和谁说话inline—— 指挥者在自身上下文中兼任所有角色零派发适合短阶段subagent—— 中枢-辐条把主代理派发到全新上下文适合代码生成这类长阶段pipeline—— 链式接力支持代理按声明顺序依次增强草案mob—— 网状协作支持代理并行贡献附带一轮有界的异议确认。质量门控字段reviewerreview_artifactreviewer_max_iterations默认 2在工件产出后、人工批准门前插入独立质量评审summary_confirmation: required生成工件前必须先让用户确认澄清问题汇总Looks correct回执防止 AI 自问自答直接产出。✍️ 三段式 BodySteps / Sensors / LearnFrontmatter 之下Body 固定按顺序包含三个分区分区状态放什么## Steps必填且必须有内容代理要执行的祈使句步骤加载上下文、生成问题清单、产出工件、呈现批准门## Sensors已填充简洁的传感器摘要输出位置、Imports:行镜像 frontmatter 的sensors:、Upstream targets:行## Learn已填充指向 stage-protocol.md §13 学习循环契约的简洁指针工作时维护memory.md日记在人工门前持久化已确认的经验三段式分区是预先声明的v0.3.0 只填了## Stepsv0.5.0 补充## Sensors和## Learn时只是插槽式填入无需重构正文。可以对照 domain-design.md 查看三段齐全的真实示例。有一条边界值得记住阶段文件是框架产物形状不可变——工作流运行期间不会重写## Steps/## Sensors/## Learn结构。你在文件里改的每一处都应该是作为框架工程师的刻意修改。⚙️ YAML 是唯一事实源stage-graph.json 绝不手改这是新手最容易踩的坑编辑阶段 .md 的 YAML → 编译 → stage-graph.json → 运行时读取所有阶段文件的 YAML Frontmatter 是权威来源stage-graph.json是编译产物构建输出由 aidlc-graph.ts 生成compile --check会在内存中重编译并比对JSON 与 YAML 不一致即构建失败。所以规则只有一条改 YAML然后重新编译绝不手改 JSON。手改要么被下次编译覆盖要么触发漂移检查。编译后生成的图包含计算字段display_order由requires_stage拓扑排序得出它不写在 YAML 里也不需要写。另一个重要约定阶段文件不硬编码工件路径根。produces[]只声明工件名字引擎在执行时把名字解析到当前意图的记录目录下见 15-stage-definition.md 的 Artifact paths are engine-resolved 一节。在outputs:里写死工作区根路径属于文档错误而非行为契约。✅ 新手清单正确读写一个阶段文件新写阶段复制 scope-definition.md 作模板它是官方可直接复制粘贴的范例改依赖同步更新requires_stage、consumes、produces三组列表并保留inputs:/outputs:的人话描述与图声明一致改执行只动mode、lead_agent、support_agents注意pipeline/mob要求support_agents非空加评审声明reviewer时必须同时给review_artifact且它必须是produces[]中的一个必填 Markdown 工件校验阶段字段约束由 aidlc-stage-schema.ts 定义未知键会被 schema 拒绝——预留字段when、on_failure、blocks_on等有专门命名空间不要自己发明新键。延伸阅读Anatomy of a Stage 从阶段是工作流原子的角度带你完整走一遍Adding a Stage 则手把手教你从零接入一个新阶段。【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflows创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
