| name | rpiv-loop:flow-status |
| description | 查看过程文件的状态 |
| allowed-tools | Bash, Edit, AskUserQuestion |
| version | 2.17.14 |
<rpiv-loop-root> 解析顺序:环境变量 RPIV_LOOP_ROOT -> CLAUDE_PLUGIN_ROOT -> 当前插件根目录;均不存在时停止并请用户配置 RPIV_LOOP_ROOT 或 CLAUDE_PLUGIN_ROOT。
/rpiv-loop:flow-status
调用
uv run --no-project python <rpiv-loop-root>/tools/flow_status.py $ARGUMENTS
输出规则
- 原样复述 stdout 中
__NEED_LLM__ 行之前的全部内容到主响应区,保持原 markdown 表格、符号、缩进。严禁总结、压缩、省略、加 Insight、加解读、加下一步建议。脚本退出码非 0 时简要点出失败原因,仍不增加额外发挥。
- 若 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,不加解读。