企业官网建设流程全解析

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-workflows

AI-DLC（AI-Driven Life Cycle）阶段跳转机制，是这套面向 AI coding agent 的自适应工作流系统中最具威力也最需要小心的功能：通过一条/aidlc --stage或/aidlc --phase命令，你可以让工作流瞬间前进、后退甚至重做任意阶段。本文带你用 5 分钟彻底搞懂 AI-DLC 阶段跳转的规则、三种方向、以及跳错位置的 3 大风险，附官方文档与源码路径，新手也能快速上手。🧭

什么是 AI-DLC 阶段跳转（Jump）？

AI-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 分支）会做以下事情：

此外，作用域（Scope）校验同样适用：如果目标阶段在当前 scope 下属于被跳过的阶段，引擎会直接拒绝并提示 "Stage ... is skipped for scope ..."。这是防止把流程落点放在计划外阶段的关键防线。🛡️

E2E 测试 tests/e2e/t56-workflow-forward-jump.test.ts 就固化了一条已知答案：从reverse-engineering前进到requirements-analysis，被跳过阶段恰好是["reverse-engineering"]，审计中出现STAGE_JUMPED+Direction: FORWARD。

后退跳转：规则与"重置连锁"

后退跳转是 AI-DLC 阶段跳转中最"重"的操作，因为它会连锁重置下游：

1. 重置范围：目标阶段 + 其后所有在当前计划中应执行（EXECUTE）的阶段，凡处于已完成[x]、进行中[-]、已跳过[S]等状态的，一律回到[ ]（pending）待办状态
2. 完成数回退：Completed计数按实际重置数量减少。测试 tests/e2e/t57-workflow-backward-jump.test.ts 的已知答案是：从 20 个[x]阶段后退到reverse-engineering，恰好重置 9 个在计划内的阶段，completed_count从 20 变为 11
3. Phase 进度回退：目标之后所有含可执行阶段的 Phase，其进度行回到Pending；目标所在 Phase 变为Active
4. 状态机对称性：按状态机契约（见 docs/reference/12-state-machine.md），前进跳转负责Pending → Skipped（被跳过的阶段），后退跳转负责Verified/Active → Pending的回退——两条路径共同维持状态文件与审计的一致性
5. 审计绑定失效范围：后退跳转的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）

小结

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