核心用法
workflow-tools 是一个综合性的工作流工具集 skill，通过统一的 /wt 命令提供四大子功能：
1. 循环检测 (/wt loops)：扫描代码库中的 DEFERRED、PLACEHOLDER、TODO、FIXME、HACK、XXX 等未闭环标记，按高/中/低优先级分类输出
2. 并行决策 (/wt parallel)：基于五因子框架（Team、Coupling、Interface、Pattern、Integration）评估任务是否适合并行执行
3. MCE 分析 (/wt mce)：检测超过 200 行阈值的文件，提供基于函数边界和逻辑分组的分拆建议
4. 子工作流 (/wt subworkflow)：将任务委托给 ClawHub 生态中的专业化 skill 执行，支持后台运行
显著优点
- 一体化整合：将原本独立的 4 个 skill（loop-closer、parallel-decision、MCE、subworkflow-spawner）合并为统一接口，降低认知负担
- 决策框架严谨：并行/串行评估基于经过验证的五因子模型，避免直觉判断失误
- 零外部依赖：核心功能完全在本地 agent 信任边界内运行，不调用第三方 API
- 输出结构化：所有结果写入
output/目录的标准化 Markdown 文件，便于追踪和审计 - 可配置性强：支持 YAML 配置自定义检测模式、阈值和排除路径
潜在局限
- 依赖 OpenClaw 生态：子工作流功能需要 ClawHub skill 支持，脱离该生态则部分功能受限
- 阈值静态化：MCE 的 200 行阈值虽可配置，但缺乏基于代码复杂度（如圈复杂度）的动态调整
- 模式匹配局限：循环检测基于正则匹配，可能漏检非标准标记或产生误报
- 并行评估主观性：五因子评估仍需人工判断输入，框架本身不提供自动化评分
适合人群
- 中大型项目的技术负责人，需要系统性地管理工作流债务
- 追求 MCE（Minimal Context Engineering）实践的开发团队
- 使用 Claude Code 或 OpenClaw 作为主力开发环境的开发者
- 需要标准化并行/串行决策流程的分布式团队
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 扫描范围失控 | 未正确配置 `exclude` 导致扫描 vendor/、node_modules/ 等大型目录 | 严格配置排除路径，或使用默认配置 |
| 误判文件规模 | MCE 分析仅以行数衡量，可能忽略高密度复杂代码 | 结合代码审查工具综合评估 |
| 子工作流孤儿进程 | 后台子工作流可能因异常退出而无法追踪 | 定期清理 `output/subworkflows/` 目录 |
| 决策框架僵化 | 过度依赖五因子评分，忽视领域特殊性 | 将框架作为参考而非绝对标准 |