# Rpiv Loop:flow Status

> 查看过程文件的状态

- Skill: `zhuqingxun/rpiv-loop-flow-status` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zhuqingxun/rpiv-loop-flow-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhuqingxun/rpiv-loop-flow-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhuqingxun (https://skillmd.com/u/zhuqingxun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhuqingxun/rpiv-loop-flow-status

---


> `<rpiv-loop-root>` 解析顺序：环境变量 `RPIV_LOOP_ROOT` -> `CLAUDE_PLUGIN_ROOT` -> 当前插件根目录；均不存在时停止并请用户配置 `RPIV_LOOP_ROOT` 或 `CLAUDE_PLUGIN_ROOT`。

# /rpiv-loop:flow-status

## 调用

```bash
uv run --no-project python <rpiv-loop-root>/tools/flow_status.py $ARGUMENTS
```

## 输出规则

1. **原样复述** stdout 中 `__NEED_LLM__` 行**之前**的全部内容到主响应区,保持原 markdown 表格、符号、缩进。**严禁**总结、压缩、省略、加 Insight、加解读、加下一步建议。脚本退出码非 0 时简要点出失败原因,仍不增加额外发挥。
2. 若 stdout 含 `__NEED_LLM__` 单行标记,从该行起进入"指令模式":下一行是 JSON payload,再下面的 `PROTOCOL:` 段是给你的执行指令(协议由脚本运行时下发,SKILL 不重复维护)。按 PROTOCOL 段执行,完成后重跑 `uv run --no-project python <rpiv-loop-root>/tools/flow_status.py check` 输出最终一致性结果。

## 子命令

```
留空 | all | pending | in-progress | completed | <feature> | check | fix
```

默认模式与 `all` 只展示活跃过程文件和 todo；已经归档的文件不列入状态输出。需要查看归档文件时，显式使用 `archived` 状态过滤或查询具体 `<feature>`。

## 多子项目聚合（伞目录场景）

工具默认只扫 `cwd/rpiv` 的 `.md`。在**伞/monorepo 目录**（本目录 `rpiv/` 无 md，真实状态散在各子项目）下：

- 若 `cwd/rpiv/subprojects.txt` 存在（每行一个子项目 rpiv 目录路径，`#`/空行忽略），工具**自动聚合**列出的子项目，按子项目分组展示，不再误显示全 0。
- 也可手动 `--rpiv-dir A --rpiv-dir B`（可重复）做临时聚合。
- 聚合模式下 `fix` 会拒绝执行（archive/原地改文件依赖子项目 cwd），需 `cd` 到具体子项目再 `fix`。

输出规则不变：仍**原样复述** stdout，不加解读。