工程开发
aposd-reviewing-module-design
基于《软件设计哲学》原则进行系统性代码审查与模块设计评估,旨在识别复杂度与架构缺陷。
简介
aposd-reviewing-module-design 技能提供了一套严格、基于检查表的框架,用于在代码审查、PR 流程和设计讨论期间评估软件架构。该技能植根于 John Ousterhout 的《软件设计哲学》,有助于识别导致长期技术债的“浅薄”模块、信息泄漏和结构复杂性。它强制代理超越表层语法,对接口设计、认知负荷和层次抽象进行深入的结构分析。
-
执行多阶段结构评估:复杂度症状、模块深度、信息隐藏、层次抽象以及“整合/分离”分析。
-
使用特定的红旗检测,例如穿透方法 (Pass-Through Methods)、时间分解 (Temporal Decomposition) 和类过度膨胀 (Classitis),以精确定位有问题的架构模式。
-
提供系统性的“钢铁人 (Steel-man)”验证步骤,确保设计选择在确认其意图之前不会被轻率否定。
-
生成包含关键问题、中度问题、观察结果和积极模式的结构化报告输出,以提供可操作的反馈。
-
遵循严格的重构决策程序,例如“深度 vs. 长度”规则和“整合/分离”决策矩阵。
-
专为资深工程师、架构师和自动化代码审查代理而设计。
-
适用于 PR 审查、架构评估和模块复杂度分析场景。
-
要求对“未知的未知”和泄漏的抽象概念进行批判性思考。
-
可与其他工程技能配合使用,在自动化构建管道中执行前置门控和后置门控标准。
-
输入包括源代码、模块接口和 PR 差异;输出为专业的设计审查报告。
仓库统计
- Star 数
- 233
- Fork 数
- 21
- Open Issue 数
- 3
- 主要语言
- Shell
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月1日 08:21