这是一个基于戈德拉特约束理论（Theory of Constraints, ToC）的诊断式操作手册，用于优化任意流程，包括 CI/构建流水线、开发价值流、Agent 技能或插件、以及运行时代码路径。核心思想是：任何系统在某一时刻只有一个约束，只有改善该约束才能提升全局吞吐，在非瓶颈处节省的时间是“海市蜃楼”。
适用场景：想优化却不知从何入手；局部提速未改善端到端结果；某阶段队列/WIP 堆积而其他阶段闲置；处处繁忙却产出很少；增加容量或并行度无效果；修好一个瓶颈又冒出另一个；真正限制是政策或规则而非资源；陷入“更快 vs 更安全”等权衡。不适用于已定位的明确热点、纯正确性评审、或尚未证明是约束的环节微优化。
流程（POOGI 持续改进循环）按序执行：1. 识别约束；2. 充分利用（不增加投入）；3. 让其余环节服从约束节奏；4. 提升约束（此时才加容量）；5. 重复，约束已转移，回到第一步。常见错误即跳步，如未“充分利用”就“提升”。
使用方式：先从症状表匹配情形，打开对应决策树，运行快速检查脚本（如 queries/measure-stage-times.sh、queries/measure-wip.sh、queries/utilization-vs-throughput.py），按树走到终止动作（利用/服从/提升/改政策/重复），用 assets/templates/report.md 记录，并追加调查日志。
配置：通过 config.json 定义目标吞吐指标和流程有序阶段；首次使用时若为空，会询问用户并保存。配置无法填写时也可退回内联询问、手动测量，不会阻塞。首次调查前建议阅读 gotchas.md。相关技能：complexity-optimizer、dx-harness、dev-skill:evolve。具体脚本参数、决策树细节与完整症状目录以参考资料为准。