用途:把复杂代码按 APOSD 的“复杂度下移”原则重构,目标是减少错误处理分支、压缩配置项、简化模块接口,让调用方做更少的事,阅读者需要更少的上下文。
主要能力:提供错误削减层级(Define out → Mask → Aggregate → Crash,仅应用层可崩溃)、下移复杂度的决策流程、配置参数处理建议、可读性/直观性技巧、输出门禁与原则冲突的取舍规则。
使用方式:面对每个错误条件,先判定能否重新定义语义消除错误、能否在低层屏蔽、能否合并处理、是否属于罕见不可恢复且非关键值的错误,再决定是否暴露。向接口新增参数或异常前,需同时满足三项条件:复杂度与模块现有功能密切关联、下移后能简化应用其他代码、下移后能简化本模块接口,才可下移。配置优先自动计算或提供合理默认值。呈现简化后代码前须给出技术分析表,列出每个错误条件、所用技术、门禁检查结果与理由。
适用场景:重构错误处理、精简配置项、整理调用方逻辑、提升代码直观性。
限制:不得下移与模块核心抽象无关的复杂度,否则造成信息泄漏;安全相关错误、需要区分重试策略的错误、可能造成静默数据丢失的场景、库代码不适用该层级;屏蔽或定义掉错误时需保留日志、指标或健康检查等可观测出口。技能引用的检查清单路径为 ${CLAUDE_SKILL_DIR}/checklists.md。