complexity-mitigator

复杂度缓解器

意图

在保留必要领域含义的同时，降低理解现有代码的成本。此技能是只读的路由通道和分析前置流程，不负责交付。

FACTORING -> WINNOWING

• 将代码拆分为职责、状态、效应、决策和边界。
• 保留必要的领域因素。
• 在重构前暴露规范风险因素。
• 移除、合并、重命名、局部化或委派附带因素。
• 将重复的语义区分或因果审查压力路由到 $review-fold 和 $actuating。

激活条件

适用于难以理解的现有代码、深层嵌套、布尔逻辑混杂、解析／验证／决策／效应行为混杂、跨文件跳转、隐藏状态、顺序依赖、不透明的命名，以及由理解困难导致的审查停滞。

改由以下流程处理：

• 大范围框架或层级税负 → $reduce；
• 尚未分类的审查证据 → $review-fold；
• 已分类的所有者边界压力 → $actuating；
• 非法状态或不变量所有权 → $invariant-ace；
• 缺少必要的结构形态 → $universalist；
• 实施 → $actuating 或负责该事项的工作流。

工作流

1. 选择范围：入口点、输入、输出、状态、效应和边界。
2. 将其拆分为职责、决策、状态、效应、外部义务和证明面。
3. 将每个因素归类为 essential、incidental、mixed 或 spec-risk。
4. 找出重复、支配、包含、残留、透传或位置不当的因素。
5. 保留必要因素和未解决的规范风险。
6. 按此顺序精简：委派、扁平化、重命名、局部化、合并；然后在连贯的设计决策或生命周期可以隐藏在更简单且足够的契约后时，再提取。仅供一次使用的封装无需第二个调用方；跨案例复用的泛化则需要有证据支持的共性。
7. 说明重组规则和最小证明信号。
8. 返回交接；不要实施。

Actuating 组合方式

在 Actuating 中，已纳入代码库的复杂度审查视角 负责该流程的范围和返回形式。其重点是不必要的正确性机制和重复的语义所有权，而非完整的独立理解前置流程。返回独立维护的真值、已接受的义务和证据；区分竞争的所有者与派生防护措施及独立预言。将有依据但不阻塞的改进机会与已确认的违规问题分开。不要选择修复方案、启动配套审查，也不要生成第二份前置流程、证据表或拟议修复议程。 Review Fold 负责裁决，Actuating 负责构建决策。仅在 Actuating 中，本节优先于独立工作流、路由和输出要求。独立运行时的行为不变。

输出

Complexity preflight:
- whole:
- dominant cost:
- factorization:
- retain:
- remove/collapse/delegate:
- unresolved specification risk:
- recomposition:
- proof:
- handoff:

护栏

• 不要编辑文件或提交更改。
• 不要选择架构、审查认可、变更或结案方案。
• 不要将代码行数减少误认为理解成本降低。
• 不要删除必要策略或尚未解决的外部义务。
• 不要为假设的复用而提取，也不要在连贯形态尚未显现前提取。明确说明调用方可以不再了解或执行什么；透传助手函数或保留相同义务的配置门面并不能降低理解成本。
• 如果行为不明确，请要求提供可执行的学习材料，例如示例矩阵、契约测试、夹具集或状态表。