概述
workflow-tools 是一个专注于工作流优化的 CLI 工具技能,由 Live Neon 开发维护。它将原本分散的四个独立技能(loop-closer、parallel-decision、MCE、subworkflow-spawner)整合为统一入口,提供循环检测、并行/串行决策框架、文件大小分析和子工作流编排四大核心能力。
核心用法
通过 /wt <sub-command> 调用四个子命令:
/wt loops [path]— 扫描目录中的 DEFERRED、PLACEHOLDER、TODO 等未闭合工作项,按优先级分类/wt parallel <task>— 基于团队、耦合度、接口、模式、集成五个因子评估任务是否适合并行执行/wt mce <file>— 分析文件行数是否超过 200 行 MCE 阈值,生成拆分建议/wt subworkflow <task>— 将任务委托给专门的 ClawHub 技能执行,支持后台运行
配置通过 .openclaw/workflow-tools.yaml 或 .claude/workflow-tools.yaml 自定义,包括扫描模式、排除路径、行数阈值等。
显著优点
1. 一体化入口:原本需安装四个技能,现在单一命令覆盖完整工作流分析场景
2. 决策框架实用:五因子并行评估模型将主观判断结构化,特别适合技术方案评审
3. 技术债务可视化:循环检测按高/中/低优先级输出,便于冲刺规划时快速定位风险
4. MCE 合规检查:200 行阈值设计服务于大语言模型上下文效率,适合 AI 辅助开发场景
5. 纯本地执行:指令型技能(disable-model-invocation: true),不调用外部 API,结果仅写入本地 output/ 目录
局限与风险
1. 路径扫描范围无限制:/wt loops 接受任意目录参数,可扫描敏感路径,依赖用户自行使用 --exclude 规避
2. 子工作流权限叠加:/wt subworkflow 会调用其他已安装技能,实际权限为技能并集,需审慎管理已安装技能列表
3. 分析结果不自动修复:仅提供检测和建议,代码拆分、循环关闭等需手动执行
4. 阈值硬编码倾向:默认 200 行 MCE 阈值可能不适用于所有技术栈,需通过配置文件调整
适合人群
- 技术负责人进行代码评审和发布前检查
- 团队在冲刺规划中识别技术债务
- 使用 AI 辅助开发的工程师优化上下文效率
- 需要标准化并行/串行决策流程的分布式团队
常规风险
该技能为只读分析工具,不修改源文件;但路径扫描功能可能被误用于敏感目录遍历。建议通过配置文件的 exclude 字段预设排除规则,并在 CI/CD 中固定扫描范围。子工作流功能会扩展权限边界,生产环境使用前建议审计 openclaw list 中的全部已安装技能。