核心用法
workflow-tools 是一个 Agentic 扩展技能,通过统一命令 /wt 提供四项工作流诊断能力:
1. 循环检测 (`/wt loops`):扫描代码中的 TODO, FIXME, DEFERRED, PLACEHOLDER 等开放标记,按优先级(高/中/低)分类输出
2. 并行决策 (`/wt parallel`):基于五因子框架(团队独立性、任务耦合度、接口清晰度、模式一致性、集成复杂度)智能推荐任务应并行还是串行执行
3. MCE 分析 (`/wt mce`):检测超过 200 行阈值的大型文件,提供基于函数边界、逻辑分组的拆分建议
4. 子工作流 (`/wt subworkflow`):将任务委托给专门的 ClawHub 技能(如 research-, generate- 等类别)异步执行
显著优点
- 本地安全:纯指令型技能,不调用 AI 模型,不访问外部 API,所有操作在本地完成
- 零侵入分析:文件扫描为只读操作,不修改源代码
- 结构化输出:结果写入
output/子目录,便于 CI/CD 集成和审计追踪 - 可配置性强:支持
.openclaw/workflow-tools.yaml自定义检测模式、阈值和排除路径 - 决策可视化:并行/串行分析提供清晰的五因子评分表和理由说明
潜在缺点与局限性
- 路径扫描风险:
/wt loops接受任意目录参数,可能扫描敏感路径,需用户自行使用--exclude规避风险 - 子工作流权限叠加:
/wt subworkflow调用的其他技能会叠加权限范围,需提前审查已安装技能列表 - 依赖外部技能:完整功能需配合
failure-memory和constraint-engine安装 - MCE 阈值固定:默认 200 行阈值对特定语言/框架可能过严或过松
适合人群
- 中大型项目的技术负责人,需要追踪技术债务
- 采用并行开发的团队,需要结构化决策框架
- 追求代码可维护性的工程师,关注文件规模管控
- 使用 OpenClaw/Claude Code 生态的开发者
常规风险
- 路径遍历:用户可能无意扫描包含敏感数据的目录
- 权限扩张:子工作流调用可能激活未预期的高权限技能
- 误报累积:开放标记检测可能产生大量低优先级噪音,需定期清理
总体评估:这是一个设计精良的本地工作流工具集,适合纳入代码审查和项目管理流程,但需注意路径扫描和子工作流的权限管理。