---
name: pdlc-status
description: 查看项目 PDLC 状态总览（读 docs/.pdlc-state/ 输出进度）
argument-hint: [feature-id | --all]
allowed-tools: Read, Glob, Bash
layer: 1
stage: ops
produces: []
requires: []
next_step: null
terminal_state: null
---

# 项目 PDLC 状态总览

读取 `docs/.pdlc-state/` 目录下所有状态机文件，输出项目当前的 PDLC 进度、阶段分布、待办建议。

## 执行流程

### 1. 扫描状态机

1. 列出 `docs/.pdlc-state/*.json` 所有文件
2. 若无文件 → 输出：`📭 尚无 PDLC 追踪记录。运行 /pdlc-feature 或 /pdlc-fix 开始第一个功能。`
3. 否则进入下一步

### 2. 解析与分类

按 `current_stage` 字段分组：

- 🚧 进行中：`current_stage` 不在 `[feature_done, fix_done, null]`
- ✅ 已完成：`current_stage` 在 `[feature_done, fix_done]`
- ❓ 异常：JSON 无法解析或字段缺失

### 3. 输出概览

```
📊 PDLC 状态总览（共 <N> 个功能）

🚧 进行中（<M> 个）
  - F20260419-01 user-auth      当前：design       下一步：/pdlc-tdd
  - F20260419-02 pwd-reset      当前：impl         下一步：/pdlc-review
  - B20260418-01 login-crash    当前：fix_done     下一步：（完成）

✅ 已完成（<K> 个）
  - F20260415-03 feature-xyz    完成于 2026-04-16

⚠️ 待办建议
  - F20260419-01 停留在 design 超过 2 天，建议推进 /pdlc-tdd
```

### 4. 参数处理

- `$ARGUMENTS` 为空或 `--all` → 输出所有功能
- `$ARGUMENTS` 为功能ID → 只输出该功能的详情（含 history 全量）

## 参数

- `--all`（默认）：全部功能总览
- `<feature-id>`：单个功能的完整 history
- `--stale <days>`：列出停留在同一阶段超过 `<days>` 天的功能（默认 3 天）

---

**参数**：$ARGUMENTS