项目 PDLC 状态总览
读取 docs/.pdlc-state/ 目录下所有状态机文件,输出项目当前的 PDLC 进度、阶段分布、待办建议。
执行流程
1. 扫描状态机
- 列出
docs/.pdlc-state/*.json所有文件 - 若无文件 → 输出:
📭 尚无 PDLC 追踪记录。运行 /pdlc-feature 或 /pdlc-fix 开始第一个功能。 - 否则进入下一步
2. 解析与分类
按 current_stage 字段分组:
- 🚧 进行中:
current_stage不在[feature_done, fix_done, null] - ✅ 已完成:
current_stage在[feature_done, fix_done] - ❓ 异常:JSON 无法解析或字段缺失
3. 输出概览
📊 PDLC 状态总览(共 <N> 个功能)
🚧 进行中(<M> 个)
- F20260419-090000 user-auth 当前:design 下一步:/pdlc-tdd
- F20260419-100000 pwd-reset 当前:impl 下一步:/pdlc-review
- B20260418-090000 login-crash 当前:fix_done 下一步:(完成)
✅ 已完成(<K> 个)
- F20260415-110000 feature-xyz 完成于 2026-04-16
⚠️ 待办建议
- F20260419-090000 停留在 design 超过 2 天,建议推进 /pdlc-tdd
3.5 关系树视图(RFC#6)
若存在 docs/.pdlc-state/_relations.json,附加关系视图(读其 index 的 inbound/outbound):
🔗 关系链
F20260419-090000 user-auth
├─ extends → F20260415-110000 feature-xyz
└─ ← depended_on_by F20260419-100000 pwd-reset
🧩 孤立 feature(无任何关系):F20260420-130000
- 出边用
→,入边用← <反向类型> - 末尾列 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