工程開發
aposd-reviewing-module-design avatar

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
在 GitHub 查看