# Using Aidlc

> Use when 需要在 dlc-dev 仓库执行 AI DLC（Spec Pack）流程、选择/串联需求侧（raw/solution/prd/prototype/demo）与实现侧（plan/execute/finishing）技能，并用门禁避免上下文漂移、写错目录或在压力下跳过关键步骤。

- Skill: `zixun-github/using-aidlc` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add zixun-github/using-aidlc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zixun-github/using-aidlc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: zixun-github (https://skillmd.com/u/zixun-github)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zixun-github/using-aidlc

---


# using-aidlc（Spec Pack 流程唯一路由器 / Router）

## 你现在在用什么

这是一个“导航 + 门禁”型技能：在 Spec Pack（分支名 `{num}-{short-name}`）流程里，**只有本技能（Router）有权决定下一步用哪个 skill**；其它技能都是 worker，只负责本阶段门禁 + 落盘 + DoD。

**开始时必须宣布：**「我正在使用 using-aidlc 技能导航 Spec Pack 流程，正在执行 spec-context 获取上下文。」

## 渐进式展开（按需读取）

你要求的机制是“先读 Router，再按需读细则”，因此：

- 默认只读取本文件 `SKILL.md`
- 只有当 Router 需要判定某条链路时，才再读取对应链路的路由细则（R/D/I/V）

## 路由规则索引（按需阅读）

- **需求链路（R0–R4）**：`router/routing-requirements.md`
- **设计链路（D0–D2）**：`router/routing-design.md`（**R→I 过渡时必读**，见 D0 强制门禁）
- **实现链路（I1–I2 + Finish）**：`router/routing-implementation.md`
- **验证链路（V1–V4）**：`router/routing-verification.md`
- **多人协作 / Task Pack（补充）**：`router/routing-collaboration.md`（任务分支、`spec-context` 扩展字段、Phase B/C 脚本入口）
 
> 路径约定：本技能内部路径均采用**相对于本技能目录**的写法。

## Router / Worker 职责边界（强约束）

- **Router（using-aidlc）**：唯一有权决定“下一步做什么/是否跳过/走哪条链路”。
- **Worker skills**（例如 `spec-product-clarify`、`spec-plan` 等）：只负责本阶段门禁 + 产物落盘 + DoD 自检；不得在技能内部自主分流到下一个技能。

## Router 的硬门禁（必须遵守）

只要任务会读写以下路径（或其子路径），必须先执行 `spec-context` 获取上下文，并回显 `FEATURE_DIR=...`。**失败则进入 spec-init**。

**REQUIRED SUB-SKILL：正在执行 `spec-context` 获取上下文，并在对话中回显 `FEATURE_DIR=...`（允许 `(reuse)`）。**

- `{FEATURE_DIR}/requirements/*`
- `{FEATURE_DIR}/design/*`
- `{FEATURE_DIR}/implementation/*`
- `{FEATURE_DIR}/verification/*`

> 命令书写约定：默认面向 PowerShell；同一行多命令请用 `;` 分隔（不要用 `&&`）。

## AUTO_MODE 检测（无人值守模式）

Router 在获取到 `FEATURE_DIR` 后、执行路由判定前，应检测当前是否处于自动模式：

- **检测方式（满足其一即为 `AUTO_MODE=true`）**：
  - `{FEATURE_DIR}/requirements/raw.md` 的 YAML Frontmatter 中 `mode: auto`
  - 上下文中已存在 `AUTO_MODE=true` 标记（由调用方 SubAgent 注入）
- **无 Frontmatter 或 `mode` 缺失/非 `auto`**：视为 `AUTO_MODE=false`（interactive 模式），所有行为与原有逻辑一致。

`raw.md` Frontmatter 完整约定（各字段均可选，缺省值见注释）：

```yaml
---
mode: auto          # auto | interactive（默认 interactive）
skip_design: true   # D0 预设：跳过设计阶段（默认 false）
skip_stages:        # 声明式跳过阶段列表（默认空）
  - R2
  - R3
  - R4
source: auto-app    # 来源标识（仅用于追溯，不影响路由）
iteration: 1        # 迭代编号（仅用于追溯，不影响路由）
---
```

## AUTO_COMMIT 检测（自动提交开关）

Router 在获取到 `FEATURE_DIR` 后，应从 `spec-context` 输出中读取 `AUTO_COMMIT` 值：

- **来源**：`spec-context` 脚本自动读取 `{REPO_ROOT}/.aidlc/config.yaml` 中的 `auto_commit` 字段，并输出 `AUTO_COMMIT=true/false`
- **默认值**：`true`（配置文件不存在或字段缺失时）
- **行为差异**：
  - `AUTO_COMMIT=true`：所有 worker skill 中的 `git add` + `git commit` 步骤正常执行
  - `AUTO_COMMIT=false`：所有 worker skill 中的自动提交步骤被跳过，改为输出"已变更文件清单，请手动提交"

> 注意：`auto_commit` 是**项目级配置**（位于 `.aidlc/config.yaml`），不是 spec 级 frontmatter 字段。它影响所有 Spec Pack 的提交行为。

## Auto-Advance（默认自动推进）

- **默认**：未命中“硬中断（Hard stop）”时，Router 应自动推进并立即执行下一步 worker skill。
- **禁止**：输出下一步后以“是否继续/要不要执行”结束回复（除非触发硬中断）。
- **需要最小输入时**：先收集最小输入，收集到后立即执行。

## 硬中断（Hard stop：必须停下交给用户）

满足其一即硬中断（Router 必须停止并输出阻断原因 + 所需最小输入/裁决点）：

- 需要关键外部输入且无法默认推断（例如 R4 找不到 `DEMO_PROJECT_ROOT`）
- 存在重大决策分支且选错代价高（例如：对外契约/权限/口径变更、数据迁移/回滚、引入新基础设施或跨团队依赖）
- 预计实现工作量超过 1 个工作日（以影响面与不确定性为依据给出理由即可）
- 涉及不可逆/高风险操作（例如：废弃 Spec Pack，必须走专用流程）

## 软检查点（Soft checkpoint：不中断，但必须提示“可评审点”）

当生成/更新下列权威输入类产物时，Router 应继续推进，同时在输出里给出“本轮最小评审点”：

- `requirements/solution.md`（尤其 `#impact-analysis`）
- `requirements/prd.md`
- `requirements/prototype.md`
- `design/design.md`
- `implementation/plan.md`

**AUTO_MODE 行为**：当 `AUTO_MODE=true` 时，软检查点的"提示可评审点"输出被跳过，Router 直接自动推进到下一步，不做任何暂停或评审提示。硬中断规则不受影响——即使在 AUTO_MODE 下，硬中断仍必须停止。

## 候选下一步（仅在硬中断时输出）

当 Router 因硬中断停止时，必须追加“可能的下一步（候选）”并按推荐顺序列 2–5 个技能名称。

**约束（避免误导）**：

- 一旦已进入实现链路（已产出 `{FEATURE_DIR}/implementation/plan.md`），候选列表默认只允许包含 `spec-execute`（以及完成后的 `finishing-development`）。不得把 `R2/R3/R4` 或 `I1` 列为“后续可选步骤”。
- 对澄清缺口，应输出“阻断原因 + 需要的最小输入/回写点（plan.md）”，收集到后直接进入 I2。

## Router 输出协议（worker 必须遵守）

任一 worker skill 完成后，结尾必须输出 `ROUTER_SUMMARY`（建议 YAML 形态，字段固定，避免自由文本），用于 Router 自动路由：

```yaml
ROUTER_SUMMARY:
  stage: CTX | R1 | R2 | R3 | R4 | D1 | D2 | I1 | I2 | V1 | V2 | V3 | V4 | Finish
  artifacts:
    - <path>
  needs_human_review: true|false
  blocked: true|false
  block_reason: ""
  notes: ""
```

## 最小路由算法（不展开细则）

Router 每轮按以下顺序执行（细则按需读取对应 routing 文件）：

1. **入口预检（Preflight）**：若分支不合规或 `raw.md` 缺失 → 进入 R0 `spec-init`（细则见 `routing-requirements.md`）。
2. **门禁**：若下一步会读写 `{FEATURE_DIR}/...` 或写 demo → 先执行 `spec-context` 获取上下文，回显 `FEATURE_DIR=...`，**失败则进入 spec-init**。
3. **读取上一步 `ROUTER_SUMMARY`（如有）**：若 `blocked=true` → 按本文件的硬中断规则停下并给出候选下一步。
4. **D0 强制门禁（R→I 过渡）**：当 `solution.md` 已存在且下一步意图指向 I1 时，**必须**执行以下步骤，**禁止未经 D0 直接进入 I1**：
   - 必须读取 `routing-design.md`
   - 必须执行 D0 判定
   - 根据 D0 结果决定：进入 D1/D2，或“跳过 design 并进入 I1”
   - **禁止**：以“用户要最短闭环/跑通即用”为由跳过 D0；D0 判定必须执行，其“跳过 design”结论才是合法进入 I1 的依据。
5. **基于用户意图 + SSOT 文件存在性路由（按需进行读取）**：
   - 需求链路 R：见 `routing-requirements.md`
   - 设计链路 D：见 `routing-design.md`
   - 实现链路 I：见 `routing-implementation.md`
   - 验证链路 V：见 `routing-verification.md`
   - **协作补充**：当意图进入 **I2**（`spec-execute`）或已存在 `{FEATURE_DIR}/implementation/tasks/` 子目录时，**应读取** `router/routing-collaboration.md`（任务分支、`TASK_PACK_DIR`、脚本与 Phase B/C 门禁），与 `routing-implementation.md` 一并作为判定输入。
6. **Auto-Advance**：未命中硬中断则 Router 必须自动推进并立即执行下一步 worker。

## 最短闭环（仅作为入口提示）

当用户意图是“跑通最短开发闭环”时，Router 的默认路径是：

`spec-init（如需） → spec-context → spec-product-clarify → spec-plan → spec-execute → finishing-development`

> 细则与分流（是否补 PRD/原型/是否跳过 design）全部下沉到 routing 文件；其中 **R→I 过渡必须经 D0 强制门禁**（读取 `routing-design.md` 并执行 D0 判定），不得省略。

## 常见错误（Red Flags）

- **R→I 过渡时未经 D0 直接进入 I1**：`solution.md` 已存在且意图指向 I1 时，必须先读取 `routing-design.md`、执行 D0 判定，再根据结果路由。
- **以“最短闭环/跑通即用”为由跳过 D0**：D0 判定必须执行；只有 D0 的“跳过 design”结论才是合法进入 I1 的依据。