核心用法
workflow-tools 是一套命令行式工作流管理工具,通过 /wt 前缀调用四个子命令:
- `/wt loops` — 扫描代码库中的 DEFERRED、PLACEHOLDER、TODO、FIXME、HACK、XXX 等未闭合标记,按高/中/低优先级分类输出
- `/wt parallel` — 基于团队独立性、任务耦合度、接口清晰度、模式一致性、集成复杂度五因子框架,判定任务应并行还是串行执行
- `/wt mce` — 分析文件行数(默认阈值200行),识别超出最小上下文工程(MCE)标准的文件,提供基于函数边界、逻辑分组、依赖关系的拆分建议
- `/wt subworkflow` — 将任务委托给 ClawHub 生态中的专业技能(如 research-、generate-、validate-* 等类别),支持后台执行与结果监控
显著优点
1. 功能聚合:将原本分散的 loop-closer、parallel-decision、MCE、subworkflow-spawner 四个技能整合为统一入口,降低认知负担
2. 决策框架系统化:五因子并行/串行判定法填补了直觉决策的盲区,特别适合高风险部署、多人协作场景
3. 本地优先:无外部API调用,数据停留在用户代理的信任边界内,仅依赖用户已配置的模型(Claude/GPT等)
4. 可配置性强:通过 .openclaw/workflow-tools.yaml 或 .claude/workflow-tools.yaml 自定义扫描模式、阈值、排除路径
潜在缺点与局限性
- 生态依赖:subworkflow 功能依赖 ClawHub 技能生态,若特定技能未安装则无法使用
- 静态分析局限:MCE 仅基于行数与简单函数边界建议拆分,缺乏语义层面的代码复杂度分析
- 无自动修复:所有检测工具仅输出报告,不执行自动重构或循环闭合
- 并行判定主观性:五因子评估仍需人工输入任务描述,复杂场景下因子权重可能争议
适合人群
- 需要系统性管理技术债务的中大型开发团队
- 在部署策略、架构决策上需要结构化论证的Tech Lead
- 使用 OpenClaw/Claude Code 生态的开发者
- 追求代码可维护性、关注上下文窗口效率的AI辅助编程用户
常规风险
- 误报风险:自定义模式可能匹配非任务标记的注释(如文档中的"TODO"示例)
- 决策路径依赖:parallel 建议基于静态因子评估,未考虑实时资源约束(如CI并发限制)
- 数据残留:扫描结果写入
output/目录,需手动清理或纳入.gitignore - 权限边界:subworkflow 以当前代理权限执行,需确保 spawned 技能的可信度