AI-DLC阶段跳转机制完全指南前进/后退Jump的规则与风险清单【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflowsAI-DLCAI-Driven Life Cycle阶段跳转机制是这套面向 AI coding agent 的自适应工作流系统中最具威力也最需要小心的功能通过一条/aidlc --stage或/aidlc --phase命令你可以让工作流瞬间前进、后退甚至重做任意阶段。本文带你用 5 分钟彻底搞懂 AI-DLC 阶段跳转的规则、三种方向、以及跳错位置的 3 大风险附官方文档与源码路径新手也能快速上手。什么是 AI-DLC 阶段跳转JumpAI-DLC 的工作流是一条由多个阶段Stage组成的流水线分为 Ideation构思、Inception启动、Construction构建等生命周期阶段Phase。正常情况下每个阶段完成后需要你在审批门Approval Gate中确认工作流才会进入下一阶段。但当你想跳过一段或回到之前时阶段跳转Stage Jump就是为此设计的导航能力前进跳转Forward Jump从当前位置直接跳到更靠后的阶段中间阶段被标记为[S]Skipped已跳过后退跳转Backward Jump跳回某个较早的阶段并重置该阶段及其所有下游阶段的完成状态被清空需要重新执行重做Redo只重置当前目标阶段本身从该阶段原地重新执行跳转的引擎入口是 core/tools/aidlc-jump.ts它提供resolve解析方向与影响范围和execute执行状态变更两个子命令——跳转的方向判定、阶段跳过与状态改写全部由引擎完成而不是靠 AI 自由发挥这保证了行为的确定性。⚙️完整规则参考官方文档docs/guide/11-session-management.md 的 Stage Jumps 章节最常用的 3 种 AI-DLC 跳转方式1. 按阶段名跳转/aidlc --stage slug|#最直接的前进/后退跳转支持用阶段 slug 或编号指定目标/aidlc --stage code-generation # 按名称跳转 /aidlc --stage 3.5 # 按编号跳转 /aidlc --stage requirements-analysis引擎会自动比较目标阶段与当前阶段的顺序判定这是前进、后退还是重做然后执行对应的状态变更。2. 按阶段Phase跳转/aidlc --phase name|#直接跳到某个生命周期阶段的第一个可执行阶段/aidlc --phase construction # 跳到构建阶段起点 /aidlc --phase 3 # 用编号等价表达在 Cursor 中还有一个原生快捷技能/aidlc-jump见 harness/cursor/skills/aidlc-jump/SKILL.md它只是把参数原样转发给引擎的next命令行为与/aidlc --stage完全一致。3. 恢复会话时跳转Resume 菜单的 Jump to stage当你在恢复会话/aidlc的四个选项中选择Jump to stage时会走与--stage相同的跳转路径并会提醒你哪些阶段将被跳过、下游阶段可能期望的产物找不到、以及可追溯性traceability可能受到的影响。前进跳转5 条必须知道的规则执行前进跳转时引擎aidlc-jump.ts的 forward 分支会做以下事情规则说明① 中间阶段标[S]当前位置与目标之间所有进行中的阶段被标记为[S]Skipped状态文件中可查② 已完成阶段不受影响已经是[x]完成的阶段保持原样不会被误伤③ 目标阶段自动激活目标阶段的复选框被置为进行中Current Stage、Next Stage、Active Agent等字段同步改写④ 跨 Phase 时补齐审计事件若跳转跨越了生命周期阶段边界会依次记录PHASE_COMPLETED、PHASE_VERIFIED、PHASE_STARTED与正常推进的契约保持一致⑤ 工作流永不因跳转而终止工具输出中workflow_stopped恒为false——跳转只是换跑道不会提前结束工作流此外作用域Scope校验同样适用如果目标阶段在当前 scope 下属于被跳过的阶段引擎会直接拒绝并提示 Stage ... is skipped for scope ...。这是防止把流程落点放在计划外阶段的关键防线。️E2E 测试 tests/e2e/t56-workflow-forward-jump.test.ts 就固化了一条已知答案从reverse-engineering前进到requirements-analysis被跳过阶段恰好是[reverse-engineering]审计中出现STAGE_JUMPEDDirection: FORWARD。后退跳转规则与重置连锁后退跳转是 AI-DLC 阶段跳转中最重的操作因为它会连锁重置下游重置范围目标阶段 其后所有在当前计划中应执行EXECUTE的阶段凡处于已完成[x]、进行中[-]、已跳过[S]等状态的一律回到[ ]pending待办状态完成数回退Completed计数按实际重置数量减少。测试 tests/e2e/t57-workflow-backward-jump.test.ts 的已知答案是从 20 个[x]阶段后退到reverse-engineering恰好重置 9 个在计划内的阶段completed_count从 20 变为 11Phase 进度回退目标之后所有含可执行阶段的 Phase其进度行回到Pending目标所在 Phase 变为Active状态机对称性按状态机契约见 docs/reference/12-state-machine.md前进跳转负责Pending → Skipped被跳过的阶段后退跳转负责Verified/Active → Pending的回退——两条路径共同维持状态文件与审计的一致性审计绑定失效范围后退跳转的STAGE_JUMPED事件会额外记录三个字段Changed Upstream Artifacts变更的上游产物路径、Invalidated Downstream Artifacts被重置阶段失效的产物、Invalidated Downstream Reviews失效的评审记录。这份清单就是哪些东西作废了的权威答案 阶段跳转的 3 大风险新手必读风险一下游产物变陈旧Stale Artifacts前进跳过后被跳过阶段应产出的文件并不存在。下游阶段如果隐式依赖这些产物执行时就会找不到输入。跳转前的警告清单被跳过阶段、缺失产物、可追溯性影响就是引擎在提醒你这一点。建议跳转前先看警告输出跳过产物密集的阶段如需求分析要格外谨慎。风险二后退跳转 推倒重来完成度会明显掉档后退不只要重做目标阶段还要重做所有被重置的下游阶段。上例中一次后退就让completed_count掉了 9 个阶段。如果你的目的是微调而不是重做整段优先考虑用Redo重做当前阶段而不是大幅后退或用/aidlc --stage slug --single孤立运行单个阶段——它只产出该阶段的产物就停下不触碰主工作流的Current Stage适合借用一种方法论但不改变流程位置的场景风险三可追溯性断裂与审计边界跳跃跨越 Phase 边界时虽然引擎会自动补齐PHASE_COMPLETED/VERIFIED/STARTED三件套审计事件但跳过本身意味着中间阶段的决策没有产生对应产物后续的/aidlc-replay叙事和交接文档OUTCOMES.md会出现空洞。好在审计日志STAGE_JUMPED记录 Source、Target、Direction、Scope保留了完整的跳转轨迹事后仍能还原为什么从这里直接到了那里。跳转速查清单Best Practices场景推荐操作想跳过审批门卡顿的阶段/aidlc --stage target前进跳转见 docs/guide/15-troubleshooting.md想借用单一阶段的方法论/aidlc --stage slug --single孤立运行不影响主流程需求变了要回到早期阶段后退跳转随后核对审计中的失效产物清单优先重跑评审过的部分跳完想核对状态查看状态文件aidlc-state.md的[S]/[ ]标记并检查STAGE_JUMPED审计事件想限制跳转深度组合--depth minimal/standard/comprehensive设置跳转目标的执行深度小结AI-DLC 阶段跳转机制把导航自由与状态一致结合在了一起引擎统一判定方向forward / backward / redo前进标记跳过、后退连锁重置任何跳转都留下STAGE_JUMPED审计记录且永不意外终止工作流。记住一句话前进跳过要看警告后退跳转要认连锁跳完必查审计日志。更多细节可查阅跳转命令参考docs/guide/12-cli-commands.md交互模式与审批门docs/guide/07-interaction-modes.md状态机契约docs/reference/12-state-machine.md跳转引擎源码core/tools/aidlc-jump.ts【免费下载链接】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），仅供参考
