SKILL.md
唯讀
名稱
senior-architect
描述
結合現代化工具與最佳實務,為資深架構師打造的完整工具包。
Senior Architect
結合現代化工具與最佳實務,為資深架構師打造的完整工具包。
快速入門
核心功能
本 Skill 透過自動化腳本提供三項核心能力:
# 腳本 1:架構圖生成器
python scripts/architecture_diagram_generator.py [options]
# 腳本 2:專案架構分析工具
python scripts/project_architect.py [options]
# 腳本 3:相依性分析器
python scripts/dependency_analyzer.py [options]
核心功能
1. 架構圖生成器
用於架構圖生成任務的自動化工具。
特色功能:
- 自動建置骨架 (Scaffolding)
- 內建最佳實務
- 可設定的範本
- 品質檢查
使用方式:
python scripts/architecture_diagram_generator.py <project-path> [options]
2. 專案架構分析工具
全方位的分析與最佳化工具。
特色功能:
- 深入分析
- 效能指標
- 改善建議
- 自動修復
使用方式:
python scripts/project_architect.py <target-path> [--verbose]
3. 相依性分析器
適用於特定任務的進階工具。
特色功能:
- 專家級自動化
- 自訂設定
- 易於整合
- 生產環境等級的輸出
使用方式:
python scripts/dependency_analyzer.py [arguments] [options]
參考文件
架構模式
可在 references/architecture_patterns.md 中查閱完整指南:
- 詳細的模式與實務
- 程式碼範例
- 最佳實務
- 應避免的反模式 (Anti-patterns)
- 實際應用場景
系統設計工作流程
可在 references/system_design_workflows.md 中查閱完整工作流程文件:
- 步驟化流程
- 最佳化策略
- 工具整合
- 效能調校
- 疑難排解指南
技術決策指南
可在 references/tech_decision_guide.md 中查閱技術參考指南:
- 技術堆疊細節
- 設定範例
- 整合模式
- 安全性考量
- 可擴充性指南
技術堆疊
程式語言: TypeScript, JavaScript, Python, Go, Swift, Kotlin
前端: React, Next.js, React Native, Flutter
後端: Node.js, Express, GraphQL, REST APIs
資料庫: PostgreSQL, Prisma, NeonDB, Supabase
DevOps: Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
雲端服務: AWS, GCP, Azure
開發工作流程
1. 安裝與設定
# 安裝相依套件
npm install
# 或
pip install -r requirements.txt
# 設定環境變數
cp .env.example .env
2. 執行品質檢查
# 使用架構分析腳本
python scripts/project_architect.py .
# 檢視改善建議
# 套用修復
3. 導入最佳實務
請遵循以下文件中記載的模式與實務做法:
references/architecture_patterns.mdreferences/system_design_workflows.mdreferences/tech_decision_guide.md
最佳實務摘要
程式碼品質
- 遵循既有模式
- 撰寫完整的測試
- 記錄架構決策
- 定期進行 Code Review
效能
- 最佳化前先進行測量
- 使用適當的快取機制
- 最佳化關鍵路徑
- 在生產環境中持續監控
安全性
- 驗證所有輸入
- 使用參數化查詢
- 實作完善的身分驗證機制
- 保持相依套件為最新版本
可維護性
- 撰寫清晰易懂的程式碼
- 使用一致的命名規範
- 新增有幫助的註解
- 保持簡單 (KISS 原則)
常用指令
# 開發
npm run dev
npm run build
npm run test
npm run lint
# 分析
python scripts/project_architect.py .
python scripts/dependency_analyzer.py --analyze
# 部署
docker build -t app:latest .
docker-compose up -d
kubectl apply -f k8s/
疑難排解
常見問題
請參閱 references/tech_decision_guide.md 中的完整疑難排解章節。
取得協助
- 查閱參考文件
- 檢查腳本輸出訊息
- 參考技術堆疊文件
- 檢視錯誤日誌
相關資源
- 架構模式參考:
references/architecture_patterns.md - 工作流程指南:
references/system_design_workflows.md - 技術指南:
references/tech_decision_guide.md - 工具腳本:
scripts/目錄
使用時機
本 Skill 適用於執行概述中所述的工作流程或動作。
使用限制
- 僅在任務明確符合上述適用範圍時使用本 Skill。
- 請勿將輸出內容直接替代特定環境下的驗證、測試或專家審查。
- 若缺少必要的輸入、權限、安全邊界或成功標準,請停止操作並尋求進一步確認。






