pdlc-statuslisted
Install: claude install-skill kanfu-panda/pdlc-skills
# 项目 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
```
### 3.5 关系树视图(RFC#6)
若存在 `docs/.pdlc-state/_relations.json`,附加关系视图(读其 index 的 inbound/outbound):
```
🔗 关系链
F20260419-01 user-auth
├─ extends → F20260415-03 feature-xyz
└─ ← depended_on_by F20260419-02 pwd-reset
🧩 孤立 feature(无任何关系):F20260420-05
```
- 出边用 `→`,入边用 `← <反向类型>`
- 末尾列 orphans(inbound + outbound 均空的 feature)
- `_relations.json` 不存在时跳过本节(Phase 1 向后兼容);Phase 2 起关系视图进入默认总览
### 4. 参数处理
- `$ARGUMENTS` 为空或 `--all` → 输出所有功能
- `$ARGUMENTS` 为功能ID → 只输出该功能的详情(含 history 全量 + 该 feature 的关系)
- `--relations` → 只输出关系树视图
## 参数
- `--all`(默认):全部功能总览
- `<feature-id>`:单个功能的完整 history
- `--relations`:只输出关系树视图(出边 + 入边 + orphans)
- `--stale <days>`:列出停留在同一阶段超过 `<days>` 天的功能(默认 3 天)
---
**参数**:$ARGUMENTS