工程開發
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