用途:分析既有 TAKT 工作流与 facet,检测问题并输出改进建议。前提为 takt v0.47.0。与 takt-optimize 不同,本技能只读、不修改文件,输出 Markdown 分析报告。
主要能力:1) 工作流结构分析,检查 initial_step 存在性、rules.next 有效性、loop_monitors 健全迁移与报告范围、section map 一致性、文件路径存在性、parallel 结构、edit=false 与构建操作、supervise 失败迁移、CI 责任配置、command quality gate、provider_options 结构、provider_options.$ref 废弃、provider_routing 迁移、edit 权限与 session 设置等。2) facet 质量分析,按风格指南检查 persona、policy、instruction、output contract 的写法与大小限制。3) facet 分离分析,检测 persona/policy/instruction/output contract 之间的职责混入。4) 规则设计分析,检查 tag 与 ai() 判定、aggregate 使用、不可达规则、循环风险、loop 健全迁移与报告一致性、ABORT 条件。5) 内置活用分析,判断自定义 facet 能否用内置替代。6) 日志诊断,读取 .takt/logs/*.jsonl 等日志,分析循环热点、死规则、规则评估效率、ABORT 率、阶段错误与迭代效率;无日志则跳过。
使用方式:先定位目标工作流 YAML 与日志,再解析 YAML、读取 facet 并对照风格指南,必要时读取日志做诊断,最后输出含 Critical/Warning/Info 的 Markdown 报告。日志格式为 NDJSON,含 workflow_start、step_start、step_complete、phase_start、phase_complete、workflow_complete、workflow_abort 等记录类型;matchedRuleMethod 可反映规则匹配方式。
适用场景:审查与诊断 TAKT 工作流配置、facet 质量与规则设计,或在有运行日志时定位动态问题。限制:只读,不执行优化或修改文件;日志诊断依赖 .takt/logs 下已有日志,无日志时仅做静态分析;具体安装与调用命令资料未提供。