用途:作为新模块设计、重构、代码审查时的对照表与总纲,不替代具体执行 skill。触发场景包括编写新模块、新服务、新接口,用户提到设计、拆分模块、评审、重构,以及 /review、/new-feature、/optimize、/design 命令的设计阶段,也可用于评估技术债时定位坏味道。
六原则:1)模块大小适中,单文件超限是设计信号而非格式问题,默认阈值 Java ≤ 300、Go ≤ 400、Vue ≤ 200、TS ≤ 300、Python ≤ 300,项目可覆盖,主要执行交给 cc-size-check。2)减少调用深度,调用链尽量 ≤ 3 层,栈深度大于 5 视为坏味道。3)多扇入少扇出,单方法直接依赖数 ≤ 5,被依赖数越多越好。4)接口边界清晰,统一入参、出参与异常约定,推荐统一 {code, data, message} 包装,异常在边界层集中处理,早期 return 优于深嵌套。5)作用域内聚,模块内修改不越界影响其他模块,私有实现不暴露为公共 API,跨模块通信走明确 API、事件或消息,不共享可变状态,主要执行交给 cc-refactor-safety 与 cc-multi-tenant-safety。6)功能可预测,同输入同输出,写操作使用幂等键,时间统一 UTC 并在边界转换,纯函数优先,副作用集中在 IO、DB、网络边界。
使用方式:在 PR 或 Review 前逐条对照检查清单,包括大小、深度、扇出、边界、作用域、幂等与隐式依赖(时区、当前时间、随机数等)。
限制:本 skill 是总纲与决策对照表,具体执行细节在 cc-size-check、cc-api-design-safety、cc-refactor-safety、cc-multi-tenant-safety、cc-time-zone-safety、cc-redis-safety、cc-query-performance-safety 等 skill 内;调用深度与扇入扇出由本 skill 主导。资料未提供安装命令、收费与平台信息。