senior-architect

senior-architect skill 概覽

senior-architect 適合用來做什麼

senior-architect 是一個 Software Architecture skill，能把模糊的系統設計問題整理成結構化的架構決策、圖表、相依性檢視與實作取捨。它特別適合需要架構規劃、ADR 風格推理、技術堆疊比較、可擴展性檢視，或針對程式碼庫進行架構層級評估的使用者，而不是只想得到一般腦力激盪式回答的人。

最適合的使用者與任務

當你需要在 monolith、modular monolith、microservices、event-driven、CQRS、hexagonal 或 clean architecture 等模式之間做選擇時，很適合使用 senior-architect skill。它也很適合正在檢視既有 repository 的團隊，因為內建的 Python scripts 可以掃描專案結構、推測架構分層、偵測耦合，並產生 Mermaid、PlantUML 或 ASCII diagrams。

它的差異化之處

這個 skill 不只提供 prompt 指引，也包含可實際執行的 repository 工具。它的 references 涵蓋架構模式、系統設計流程與技術決策矩陣；scripts 則提供專案圖表產生、相依性分析與架構評估。當你需要根據 codebase 證據做判斷時，它會比單純的「act as a senior architect」prompt 更實用。

採用前的重要限制

這些 scripts 是啟發式掃描工具，不是正式的架構驗證器。它們最適合常見的專案結構與常見生態系，例如 Node、Python、Go、Rust、Java、Docker 和 Kubernetes。若是高度客製化的 monorepos，產生的結果應視為評審起點，而不是最終決策。

如何使用 senior-architect skill

senior-architect 安裝方式與第一批應閱讀的檔案

從 GitHub skill directory 安裝：

npx skills add alirezarezvani/claude-skills --skill senior-architect

安裝後，先閱讀 SKILL.md，了解觸發範圍與指令範例。接著檢查：

• references/architecture_patterns.md：了解各種模式取捨，以及「何時不該使用」的指引
• references/system_design_workflows.md：了解容量規劃、API 設計、遷移與可擴展性流程
• references/tech_decision_guide.md：了解 database、caching、queue、auth、frontend、cloud 與 API style 的選擇
• scripts/architecture_diagram_generator.py
• scripts/dependency_analyzer.py
• scripts/project_architect.py

這個閱讀順序能幫助你在依賴輸出結果之前，同時理解推理框架與可執行的分析工具。

讓架構輸出更好的輸入資訊

senior-architect skill 在同時取得商業脈絡與技術限制時效果最好。較弱的 prompt 是：「Design a scalable backend.」更好的 prompt 會像這樣：

Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.

有用的輸入包含預期使用者數、request volume、read/write ratio、latency target、availability target、data retention、compliance needs、team size、deployment environment、current stack、migration constraints，以及已經否決過的決策。

實務上的 senior-architect 使用流程

若是新系統，先從 reference workflows 開始：釐清功能需求、估算規模、確認非功能需求，接著再要求提出候選架構與取捨。若是既有 codebase，先執行 scripts，再請它提出建議：

python scripts/architecture_diagram_generator.py ./my-project --format mermaid

python scripts/dependency_analyzer.py ./my-project --output json

python scripts/project_architect.py ./my-project --verbose

把最相關的發現貼進 prompt：偵測到的 pattern、coupling score、circular dependencies、missing layers、package manager，以及任何 recommendations。這能讓模型根據具體證據回答，而不是被迫從模糊描述中推測架構。

用於決策與評審的 prompt 模式

若是設計決策，請要求明確的決策格式：context、options、decision criteria、recommended option、rejected alternatives、risks、migration plan 與 open questions。若是架構評審，請要求 skill 將「observed facts」、「interpretation」與「recommended changes」分開。這能降低過度自信的架構建議，也更容易把輸出轉成 ADR、roadmap item 或 engineering proposal。

senior-architect skill FAQ

senior-architect 只適合大型系統嗎？

不是。它也能協助小團隊選擇簡單架構，避免過早導入 microservices。內建的 architecture pattern reference 明確涵蓋 monolith 與 modular monolith 的取捨，因此當最佳答案是「保持簡單」時，這個 skill 一樣有用。

它比一般架構 prompt 好在哪裡？

一般 prompt 很大程度取決於你記得提供哪些資訊。senior-architect skill 加入可重複使用的決策流程、模式參考、技術比較矩陣，以及 codebase scanning scripts。當你需要的是可重複的架構評審，而不是一次性的建議時，這個組合特別有價值。

初學者可以使用這個 senior-architect skill 嗎？

可以，但初學者應把它當成引導式決策輔助，而不是權威答案。請它解釋取捨、定義術語，並標示假設。如果你不清楚自己的規模、availability target 或營運限制，請先要求 skill 列出缺少的問題，再讓它推薦設計。

什麼情況不應該使用它？

不要把它當成安全關鍵、重度合規或 production migration 決策的唯一依據。它也不能取代 profiling、load testing、cloud cost modeling，或針對特殊領域的專家評審。若是低階實作 bug，語言專用的 debugging skill 可能更適合。

如何改善 senior-architect skill 的使用效果

用可衡量限制改善 senior-architect 輸入

最常見的失敗模式，是架構建議聽起來合理，但無法落地。請加入數字來改善結果：users、requests per second、storage growth、peak multiplier、latency budget、uptime target、team size、release frequency 與 cost ceiling。即使只是粗估，也比「high scale」或「enterprise grade」這類形容詞更有用。

先使用 repository 證據，再要求變更建議

對既有專案，請包含 script output 與簡短的 file-tree summary。說明程式碼是否使用 controllers/services/repositories、domain/application/infrastructure folders、Docker、Kubernetes、message queues，或多個可部署服務。這能幫助 senior-architect 區分有意設計的架構與只是偶然命名的資料夾。

從大方向設計逐步推進到具體產物

不要停在第一版架構提案。可以接著要求 ADR、Mermaid diagram、migration sequence、risk register、database choice、API boundary 或 service ownership model。良好的迭代路徑是：high-level design → trade-off comparison → chosen architecture → diagram → ADR → phased implementation plan。

留意過度工程與缺漏假設

如果輸出建議 microservices、event sourcing、CQRS 或 distributed messaging，請追問為什麼值得承擔額外的營運複雜度。如果缺少假設，要求重新回答，明確列出 unknowns，並提供更簡單的預設方案。最好的 senior-architect 使用方式，是讓設計貼合團隊能力，而不只是追求理論上的可擴展性。