
Analyze Repo
- 49 installs
- 19 repo stars
- Updated January 20, 2026
- miles990/claude-software-skills
Helps with ai & agent building tasks.
About
analyze-repo is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.
- analyze-repo
- AI & Agent Building
- AI-coding skill
Analyze Repo by the numbers
- 49 all-time installs (skills.sh)
- +1 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #7,391 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/miles990/claude-software-skills --skill analyze-repoAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 49 |
|---|---|
| repo stars | ★ 19 |
| Last updated | January 20, 2026 |
| Repository | miles990/claude-software-skills ↗ |
What it does
Helps with ai & agent building tasks.
Files
/analyze-repo v3.0
企業級專案深度分析 — 分層視覺化 × 運作原理敘事 × 可執行建議
v3.0 新特性
| 特性 | 說明 |
|---|---|
| 🎯 三層分析架構 | Executive(5分鐘)→ Architecture Story(30分鐘)→ Deep Dive(按需) |
| 🎬 How It Works | 新增「專案如何運作」敘事章節,快速理解核心流程 |
| 📊 視覺優先 | 每層以圖表開頭,文字輔助說明 |
| 🔗 證據鏈 | 所有發現附帶 file:line 程式碼引用 |
| 🛠️ 可執行建議 | 每項建議含:問題程式碼 → 修復範例 → 驗證步驟 |
核心價值
| 輸入 | 輸出 |
|---|---|
| GitHub URL 或本地路徑 | 三層專業分析報告 — 視覺儀表板 + 運作原理敘事 + 可執行建議 |
適用場景:
- 🏢 技術主管/CTO — Layer 1 快速決策 + Layer 2 架構評估
- 👨💻 開發者 — Layer 2 理解運作原理 + Layer 3 上手指南
- 💰 投資人/Due Diligence — Layer 1 風險摘要 + Layer 2 技術深度
- 🔍 Code Review — Layer 3 逐檔案分析 + 可執行修復建議
---
報告三層架構
┌─────────────────────────────────────────────────────────────────┐
│ 📊 LAYER 1: Executive Dashboard(5-10 分鐘) │
│ ───────────────────────────────────────────────────────────── │
│ 目標:高層快速掌握專案狀態 │
│ • 單頁視覺儀表板(健康雷達圖 + 風險熱力圖) │
│ • 一句話定位 + 30 秒專案摘要 │
│ • 3 個關鍵發現卡片(含即時行動建議) │
│ • 競品定位矩陣 │
├─────────────────────────────────────────────────────────────────┤
│ 🏗️ LAYER 2: Architecture Story(30-60 分鐘) │
│ ───────────────────────────────────────────────────────────── │
│ 目標:理解專案如何運作 │
│ • 🎬「這個專案如何運作」流程敘事(核心創新) │
│ • C4 四層架構圖(Context → Container → Component → Code) │
│ • 資料流序列圖(主要使用場景) │
│ • 技術決策分析(為什麼用 X 而非 Y) │
│ • 8 維度品質評估詳解 │
├─────────────────────────────────────────────────────────────────┤
│ 🔬 LAYER 3: Deep Dive Reference(按需查閱) │
│ ───────────────────────────────────────────────────────────── │
│ 目標:可執行的改進行動 │
│ • 每個發現附帶 file:line 證據鏈 │
│ • 可執行建議:問題碼 → 修復範例 → 驗證步驟 │
│ • 技術債務修復清單(含優先級 + 工時估算) │
│ • 完整檔案結構與關鍵入口點 │
└─────────────────────────────────────────────────────────────────┘使用方式
# 基本分析(預設輸出完整三層報告)
/analyze-repo https://github.com/owner/repo
/analyze-repo .
/analyze-repo /path/to/project
# 指定深度(可選)
/analyze-repo . --depth=executive # 僅 Layer 1(快速摘要)
/analyze-repo . --depth=story # Layer 1 + 2(含運作原理)
/analyze-repo . --depth=full # 完整三層(預設)
# 指定視角(可選,影響內容側重)
/analyze-repo . --perspective=executive # 側重決策指標
/analyze-repo . --perspective=architect # 側重架構設計
/analyze-repo . --perspective=developer # 側重上手指南
/analyze-repo . --perspective=investor # 側重風險評估
# 組合使用
/analyze-repo . --depth=story --perspective=developer---
分析框架
你是資深軟體架構顧問,具備 arc42、C4 Model、SOLID/DDD 專業知識。
Phase 1: 資料收集與情境建立
1.1 來源判斷
https://github.com/→ GitHub API + 原始碼分析- 本地路徑 → 直接檔案系統存取
1.2 關鍵檔案掃描(優先順序)
| 類別 | 檔案 | 分析目的 |
|---|---|---|
| 套件管理 | package.json, requirements.txt, pyproject.toml, Cargo.toml, go.mod, pom.xml, build.gradle | 依賴分析、版本檢查 |
| 容器化 | Dockerfile, docker-compose.yml, k8s/ | 部署架構 |
| 文件 | README.md, CLAUDE.md, docs/, ARCHITECTURE.md | 專案意圖 |
| 配置 | tsconfig.json, next.config.*, .env.example, config/ | 技術決策 |
| CI/CD | .github/workflows/, .gitlab-ci.yml, Jenkinsfile | 自動化成熟度 |
| 測試 | tests/, __tests__/, spec/, *_test.go, *.spec.ts | 測試覆蓋 |
| 入口點 | main.*, index.*, app.*, src/ | 程式碼結構 |
| 安全 | .env, secrets/, credentials*, *.pem, *.key | 敏感資訊檢查 |
1.3 專案元數據收集
- 程式碼行數(按語言分類)
- 提交歷史(活躍度、貢獻者分佈)
- Issue/PR 統計(如為 GitHub)
- License 類型
---
Phase 2: 專案運作原理(How It Works)🆕
核心創新:讓讀者在 5 分鐘內理解「這個專案到底在做什麼、怎麼做」
2.1 核心流程敘事
必須回答的問題: 1. 輸入是什麼? — 用戶/系統觸發什麼 2. 處理過程? — 核心邏輯如何運作 3. 輸出是什麼? — 最終產生什麼結果
格式:
一句話版本:
用戶 {觸發方式} → 系統 {處理流程} → 產生 {最終結果}
詳細版本(3-5 段):
1. 觸發點:{描述入口}
2. 核心處理:{描述主要邏輯}
3. 資料流向:{描述資料如何流動}
4. 輸出結果:{描述產出}2.2 主要使用場景序列圖
識別 2-3 個最重要的使用場景,為每個場景生成:
sequenceDiagram
actor User
participant Frontend
participant API
participant Service
participant DB
Note over User,DB: 場景:{場景名稱}
User->>Frontend: 1. {觸發動作}
Frontend->>API: 2. {API 呼叫}
API->>Service: 3. {業務處理}
Service->>DB: 4. {資料操作}
DB-->>Service: 5. {回傳資料}
Service-->>API: 6. {處理結果}
API-->>Frontend: 7. {回應}
Frontend-->>User: 8. {展示結果}2.3 關鍵程式碼入口點
每個流程必須標註具體檔案位置:
| 階段 | 檔案位置 | 函數/類別 | 說明 |
|---|---|---|---|
| 入口 | src/main.ts:15 | bootstrap() | 應用啟動 |
| 路由 | src/routes/index.ts:42 | router.get() | 請求分發 |
| 邏輯 | src/services/core.ts:128 | processRequest() | 核心處理 |
| 資料 | src/models/data.ts:23 | DataModel | 資料結構 |
2.4 核心演算法/邏輯說明
如果專案有獨特的演算法或邏輯,用以下格式說明:
演算法名稱:{名稱}
用途:{解決什麼問題}
複雜度:O(n) / O(log n) / etc.
虛擬碼:
1. {步驟 1}
2. {步驟 2}
3. {步驟 3}
實際程式碼位置:`src/algorithms/xxx.ts:45-78`---
Phase 3: 架構分析(C4 Model 四層)
Level 1: System Context(系統情境)
- 識別系統邊界
- 外部使用者/角色
- 外部系統整合
- 🆕 附帶說明:用 2-3 句話解釋圖表含義
Level 2: Container(容器)
- 應用程式
- 資料儲存
- 訊息佇列
- 容器間通訊協定
- 🆕 技術選型原因:為什麼選這個技術
Level 3: Component(元件)
- 主要模組/套件
- 關鍵類別/函數
- 模組職責劃分
- 🆕 程式碼位置:每個元件的檔案路徑
Level 4: Code(程式碼層級)
- 核心演算法
- 設計模式使用
- 關鍵資料結構
- 🆕 程式碼片段:展示關鍵實作
---
Phase 3: 品質評估(8 維度)
使用 1-100 分制評估:
| 維度 | 評估標準 | 權重 |
|---|---|---|
| 可維護性 | 程式碼複雜度、命名規範、模組化程度、Maintainability Index | 15% |
| 可測試性 | 測試覆蓋率、測試品質、Mock/Stub 使用 | 12% |
| 可擴展性 | 架構彈性、水平/垂直擴展能力、設計模式 | 12% |
| 安全性 | 依賴漏洞、敏感資訊暴露、OWASP Top 10 | 15% |
| 文件完整度 | README、API 文件、架構文件、註解品質 | 10% |
| 架構健康度 | SOLID 合規、關注點分離、層次清晰 | 15% |
| 依賴健康度 | 依賴數量、版本過時程度、循環依賴 | 11% |
| 開發者體驗 | 上手難度、開發工具配置、錯誤訊息品質 | 10% |
綜合健康分數 = 加權平均
---
Phase 4: 技術債務分析
4.1 債務分類(SQALE 模型)
| 類別 | 偵測指標 |
|---|---|
| 可靠性債務 | 未處理例外、空指標風險、資源洩漏 |
| 安全性債務 | 已知漏洞、硬編碼密鑰、SQL 注入風險 |
| 可維護性債務 | 重複程式碼、過長函數、過深巢狀 |
| 效能債務 | N+1 查詢、無快取策略、同步阻塞 |
| 測試債務 | 低覆蓋率、無整合測試、脆弱測試 |
4.2 債務量化
- 修復時間估算(人天)
- 優先級排序(Impact × Effort 矩陣)
- 債務趨勢(如有歷史資料)
---
Phase 5: 依賴關係分析
5.1 依賴圖譜
- 內部模組依賴關係
- 外部套件依賴
- 循環依賴偵測
- 扇入/扇出分析(Afferent/Efferent Coupling)
5.2 依賴健康檢查
| 檢查項 | 風險等級 |
|---|---|
| 已知 CVE 漏洞 | 🔴 Critical |
| 重大版本落後(>2 版) | 🟠 High |
| 無維護套件(>2 年無更新) | 🟠 High |
| 次要版本落後 | 🟡 Medium |
| 授權合規風險 | 🟡 Medium |
---
Phase 6: 安全性評估
6.1 靜態掃描摘要
- 依賴漏洞(npm audit / pip-audit / cargo-audit 等效分析)
- 敏感資訊暴露(API Keys、密碼、Token)
- 不安全程式碼模式
6.2 OWASP Top 10 檢查清單
| 風險 | 檢查項目 |
|---|---|
| A01 Broken Access Control | 授權檢查、路由保護 |
| A02 Cryptographic Failures | 加密演算法、密鑰管理 |
| A03 Injection | 輸入驗證、參數化查詢 |
| A07 Authentication | 身份驗證機制、Session 管理 |
| A09 Logging & Monitoring | 日誌記錄、異常追蹤 |
---
Phase 7: 競品與價值分析
7.1 獨特價值主張 (UVP)
- 核心解決的問題
- 差異化特點
- 目標使用者
7.2 不可替代性評估(5 分制)
| 維度 | 評估 |
|---|---|
| 技術獨特性 | 核心演算法、專利、獨特實現 |
| 生態整合深度 | 與其他系統的整合程度 |
| 遷移成本 | 換到替代方案的成本 |
| 學習曲線 | 團隊上手難度 |
| 社群活躍度 | 維護者、貢獻者、Issue 回應 |
7.3 競品比較矩陣
識別 2-3 個主要競品/替代方案,進行功能對比:
必須包含的比較維度:
| 維度 | 說明 |
|---|---|
| 核心功能 | 主要解決的問題 |
| 技術架構 | 技術選型差異 |
| 擴展性 | 是否支援插件/擴展 |
| 學習曲線 | 上手難度 |
| 社群活躍度 | 維護狀態、Issue 回應 |
| 授權方式 | 開源/商業/混合 |
範例格式:
| 特性 | 本專案 | 競品 A | 競品 B | 競品 C |
|------|--------|--------|--------|--------|
| 核心功能 | ✅ 完整 | ⚠️ 部分 | ✅ 完整 | ❌ 無 |
| 擴展性 | ✅ Plugin | ❌ 無 | ⚠️ 有限 | ✅ 完整 |
| 學習曲線 | ⚠️ 中等 | ✅ 簡單 | ❌ 困難 | ⚠️ 中等 |7.4 適用場景分析 🆕
用餅圖呈現最適合的使用場景佔比:
pie title 最適合使用場景
"場景 A" : 35
"場景 B" : 25
"場景 C" : 20
"場景 D" : 15
"其他" : 5並提供採用建議矩陣:
| 情境 | 建議 | 說明 |
|---|---|---|
| 情境 A | ✅ 強烈推薦 | {為什麼適合} |
| 情境 B | ✅ 推薦 | {為什麼適合} |
| 情境 C | ⚠️ 可能過重 | {為什麼可能不適合} |
| 情境 D | ❌ 不適用 | {為什麼不適合} |
---
Phase 7.5: 市場未來價值分析
7.5.1 技術趨勢對齊度
評估專案與當前/未來技術趨勢的契合程度:
| 趨勢領域 | 評估項目 |
|---|---|
| AI/ML 整合能力 | 是否有 AI 整合點、LLM 友好 API、向量資料庫支援 |
| 雲原生成熟度 | 容器化、K8s 支援、Serverless 適配性 |
| 邊緣運算準備度 | 輕量化可能性、離線能力、低延遲設計 |
| Web3/去中心化 | 區塊鏈整合潛力、去中心化架構可能性 |
| 永續性/綠色運算 | 資源效率、能耗優化潛力 |
7.5.2 市場定位分析
quadrantChart
title Market Position Matrix
x-axis Low Tech Complexity --> High Tech Complexity
y-axis Low Market Demand --> High Market Demand
quadrant-1 Star (Invest)
quadrant-2 Question Mark (Evaluate)
quadrant-3 Pet (Divest)
quadrant-4 Cash Cow (Maintain)7.5.3 成長潛力指標
| 指標 | 評估方式 |
|---|---|
| TAM/SAM/SOM 估算 | 目標市場規模、可服務市場、可獲取市場 |
| 成長動能 | GitHub Stars 趨勢、npm 下載量、社群活躍度成長率 |
| 網路效應潛力 | 使用者越多價值越高的特性 |
| 平台化可能性 | 是否可發展為生態平台 |
| 商業模式彈性 | 開源/SaaS/企業版等多元變現路徑 |
7.5.4 風險與機會矩陣(SWOT 延伸)
| 類別 | 內部 | 外部 |
|---|---|---|
| 正面 | 優勢 Strengths | 機會 Opportunities |
| 負面 | 劣勢 Weaknesses | 威脅 Threats |
7.5.5 投資/採用建議
基於以上分析,給出明確建議:
- 🟢 強烈推薦 — 技術先進、市場前景佳、風險可控
- 🟡 謹慎考慮 — 有價值但存在特定風險或限制
- 🔴 不建議 — 技術過時、市場萎縮、或風險過高
7.5.6 版本演進分析 🆕
如果專案有 CHANGELOG 或 Git 歷史,分析版本演進:
Gantt 時間軸視覺化:
gantt
title 專案版本演進
dateFormat YYYY-MM-DD
section 核心功能
v1.0 初始版本 :done, 2024-01-01, 30d
v2.0 重大更新 :done, 2024-03-01, 60d
v3.0 架構重構 :done, 2024-06-01, 90d
section 整合功能
Plugin 系統 :done, 2024-04-01, 45d
API 擴展 :active, 2024-08-01, 60d關鍵版本里程碑表:
| 版本 | 日期 | 重點功能 | 影響 |
|---|---|---|---|
| v1.0 | YYYY-MM-DD | 初始發布 | 建立基礎 |
| v2.0 | YYYY-MM-DD | {重大功能} | {帶來的改變} |
| v3.0 | YYYY-MM-DD | {重大功能} | {帶來的改變} |
演進趨勢分析:
- 開發節奏:{活躍/穩定/緩慢}
- 版本策略:{語意化版本/日期版本/其他}
- 向後相容性:{良好/需注意/經常破壞}
---
Phase 8: 策略建議生成
8.1 優先級矩陣
使用 Impact × Effort 矩陣對所有發現進行分類:
quadrantChart
title Priority Matrix
x-axis Low Effort --> High Effort
y-axis Low Impact --> High Impact
quadrant-1 Do First (Quick Wins)
quadrant-2 Plan (Major Projects)
quadrant-3 Delegate/Automate
quadrant-4 Evaluate (Consider Later)8.2 可執行建議框架 🆕
核心原則:每項建議必須可立即執行,不需額外研究
每項建議必須包含以下結構:
| 欄位 | 說明 | 必填 |
|---|---|---|
| ID | 唯一識別碼(如 REC-001) | ✅ |
| 類別 | Architecture / Security / Performance / Quality / Documentation / DevOps | ✅ |
| 標題 | 簡潔描述(< 10 字) | ✅ |
| 重要性 | ⭐⭐⭐ 核心/必要 / ⭐⭐ 重要/建議 / ⭐ 可選/增強 | ✅ |
| 優先級 | 🔴 Critical / 🟠 High / 🟡 Medium / 🟢 Low | ✅ |
| 問題位置 | 🆕 file:line 具體程式碼位置 | ✅ |
| 問題程式碼 | 🆕 展示有問題的實際程式碼片段 | ✅ |
| 修復範例 | 🆕 展示修復後的程式碼範例 | ✅ |
| 驗證步驟 | 🆕 如何驗證修復成功(命令或測試) | ✅ |
| 成功指標 | 可衡量的驗收標準 | ✅ |
建議格式範例:
### REC-001: 修復 SQL 注入漏洞
| 屬性 | 值 |
|------|-----|
| 類別 | 🔒 Security |
| 重要性 | ⭐⭐⭐ 核心 |
| 優先級 | 🔴 Critical |
#### 📍 問題位置
- `src/api/users.ts:87`
- `src/api/products.ts:142`
#### ❌ 問題程式碼// src/api/users.ts:87 const query = SELECT * FROM users WHERE id = ${userId}; // ^^^^^^^^^ SQL 注入風險
#### ✅ 修復範例// src/api/users.ts:87 const query = 'SELECT * FROM users WHERE id = $1'; const result = await db.query(query, [userId]);
#### 🧪 驗證步驟1. 執行安全掃描
npm run security:audit
2. 測試注入防護
curl "localhost:3000/api/users/1'%20OR%20'1'='1"
預期:400 Bad Request(而非資料洩漏)
#### ✓ 成功指標
- [ ] 所有 SQL 查詢使用參數化
- [ ] `npm audit` 無 Critical 警告8.2.1 重要性與優先級的區別
- 重要性 (Importance):對專案長期健康的影響程度
- ⭐⭐⭐ 核心/必要 — 不做會導致專案失敗或嚴重風險
- ⭐⭐ 重要/建議 — 顯著提升專案品質或降低風險
- ⭐ 可選/增強 — 錦上添花,提升體驗
- 優先級 (Priority):應該何時執行
- 結合重要性 + 緊迫性
quadrantChart
title Importance vs Priority Matrix
x-axis Low Priority --> High Priority
y-axis Low Importance --> High Importance
quadrant-1 Strategic (Plan Carefully)
quadrant-2 Critical (Do Now)
quadrant-3 Optional (If Time Permits)
quadrant-4 Quick Wins (Easy Wins)8.3 建議優先順序規則
1. 安全性 Critical → 必須立即處理 2. 影響生產環境穩定性 → 高優先級 3. Quick Wins(高影響、易修復) → 優先執行 4. 技術債務 → 按累積風險排序 5. 增強功能 → 按業務價值排序
8.4 建議分類視覺化
flowchart TB
subgraph Critical["🔴 立即處理"]
C1[安全漏洞]
C2[生產環境風險]
end
subgraph High["🟠 短期處理"]
H1[架構問題]
H2[效能瓶頸]
end
subgraph Medium["🟡 規劃處理"]
M1[技術債務]
M2[測試覆蓋]
end
subgraph Low["🟢 適時處理"]
L1[文件完善]
L2[程式碼風格]
end---
Phase 9: Mermaid 圖表生成
必須產生以下圖表:
9.1 C4 Context Diagram
C4Context
title System Context Diagram
Person(user, "User")
System(system, "Target System")
System_Ext(ext, "External System")
Rel(user, system, "Uses")
Rel(system, ext, "Integrates")9.2 Container Diagram
C4Container
title Container Diagram
Container(web, "Web App", "React")
Container(api, "API", "Node.js")
ContainerDb(db, "Database", "PostgreSQL")9.3 模組依賴圖
flowchart LR
subgraph Core
A[Module A]
B[Module B]
end
A --> B9.4 技術棧總覽
flowchart TB
subgraph Frontend
F1[React]
end
subgraph Backend
B1[Node.js]
end
subgraph Data
D1[(PostgreSQL)]
end---
輸出結構(三層架構)
產生完整 Markdown 報告(詳見 extended/output-template.md):
╔════════════════════════════════════════════════════════════════╗
║ 📊 LAYER 1: Executive Dashboard(5-10 分鐘) ║
╠════════════════════════════════════════════════════════════════╣
1. Executive Summary(視覺儀表板)
- 🎯 一句話定位
- 📊 健康分數雷達圖(視覺化)
- ⚠️ 3 個關鍵風險卡片
- 🚀 立即行動建議(Top 3)
- 📈 競品定位矩陣圖
2. 30 秒專案摘要
- 這是什麼?(一段話)
- 解決什麼問題?
- 技術棧一覽
╠════════════════════════════════════════════════════════════════╣
║ 🏗️ LAYER 2: Architecture Story(30-60 分鐘) ║
╠════════════════════════════════════════════════════════════════╣
3. 🎬 How It Works(專案如何運作)🆕
- 核心流程敘事(輸入 → 處理 → 輸出)
- 主要使用場景序列圖(2-3 個)
- 關鍵程式碼入口點表
- 核心演算法/邏輯說明
4. Architecture Analysis(架構分析)
- C4 四層圖表(附說明文字)
- 架構模式識別
- 技術選型分析(為什麼選 X)
- 架構決策記錄 (ADR) 推測
5. Quality Assessment(品質評估)
- 8 維度雷達圖
- 各維度詳細評分與說明
- 優勢與風險清單
6. Value & Competitive Analysis(價值分析)
- UVP 陳述
- 不可替代性評分
- 競品比較矩陣
- 市場定位分析
╠════════════════════════════════════════════════════════════════╣
║ 🔬 LAYER 3: Deep Dive Reference(按需查閱) ║
╠════════════════════════════════════════════════════════════════╣
7. Technical Debt Report(技術債務報告)
- 債務分類清單(附 file:line)
- 優先級矩陣
- 修復建議(含程式碼範例)
8. Dependency Analysis(依賴分析)
- 依賴圖譜
- 健康檢查報告
- 循環依賴警告
9. Security Assessment(安全評估)
- 漏洞掃描摘要
- OWASP 檢查清單
- 風險等級分類(附 file:line)
10. 🛠️ Actionable Recommendations(可執行建議)🆕
- 按優先級分類:
* 🔴 立即處理
* 🟠 短期處理
* 🟡 規劃處理
* 🟢 適時處理
- 每項建議包含:
* 📍 問題位置(file:line)
* ❌ 問題程式碼
* ✅ 修復範例
* 🧪 驗證步驟
* ✓ 成功指標
11. Appendix(附錄)
- 完整目錄結構
- 關鍵檔案清單與說明
- 術語表
- 分析方法說明---
執行準則
✅ 必須遵守
1. 完整讀取 — 確保足夠檔案進行準確分析 2. 客觀評估 — 基於實際品質評分,避免過度樂觀或悲觀 3. 具體量化 — 盡可能提供數字而非模糊描述 4. 圖表正確 — 確保 Mermaid 語法正確可渲染 5. 可行建議 — 每項建議必須具體可執行
❌ 避免事項
1. 沒有根據的推測 2. 過度技術術語(根據 perspective 調整) 3. 模糊的評語(如「還不錯」、「有待改進」) 4. 遺漏關鍵風險
---
參考資源
- arc42 Template — 軟體架構文件標準
- C4 Model — 架構視覺化方法
- SQALE Method — 技術債務評估
- OWASP Top 10 — Web 安全風險
---
相關 Skills
/evolve— 自主完成複雜目標/commit— 提交程式碼變更/code-review— 深度程式碼審查
---
ARGUMENTS: $ARGUMENTS
輸出模板 v3.0
三層架構:Executive Dashboard → Architecture Story → Deep Dive Reference
完整的 Markdown 報告模板:
# 專案分析報告:{專案名稱}
> 分析日期:{YYYY-MM-DD}
> 分析版本:v3.0
> 分析工具:Claude Code analyze-repo Skill
---
# 📊 LAYER 1: Executive Dashboard
> 預計閱讀時間:5-10 分鐘
---
## 1. Executive Summary
### 一句話定位
> {用一句話描述這個專案的核心功能、目標使用者和獨特價值}
### 健康分數總覽
綜合健康分數:{score}/100 {健康等級}
可維護性 ████████░░ {score1}/100 可測試性 ███████░░░ {score2}/100 可擴展性 ██████░░░░ {score3}/100 安全性 █████████░ {score4}/100 文件完整度 ███████░░░ {score5}/100 架構健康度 ████████░░ {score6}/100 依賴健康度 ██████░░░░ {score7}/100 開發者體驗 ███████░░░ {score8}/100
### 關鍵發現(Top 5)
| # | 發現 | 影響 | 緊急度 |
|---|------|------|--------|
| 1 | {finding1} | {impact} | 🔴 |
| 2 | {finding2} | {impact} | 🟠 |
| 3 | {finding3} | {impact} | 🟠 |
| 4 | {finding4} | {impact} | 🟡 |
| 5 | {finding5} | {impact} | 🟢 |
### 立即行動建議
1. 🔴 **{action1}** — {原因} → [詳見 REC-001](#rec-001)
2. 🟠 **{action2}** — {原因} → [詳見 REC-002](#rec-002)
3. 🟡 **{action3}** — {原因} → [詳見 REC-003](#rec-003)
---
## 2. 30 秒專案摘要
### 這是什麼?
> {一段話描述專案的本質和目的}
### 解決什麼問題?
| 問題 | 本專案的解法 |
|------|--------------|
| {problem1} | {solution1} |
| {problem2} | {solution2} |
### 技術棧一覽
flowchart LR subgraph Frontend F["{frontend_tech}"] end subgraph Backend B["{backend_tech}"] end subgraph Data D[("{database}")] end subgraph Infra I["{infrastructure}"] end F --> B --> D B --> I
### 競品定位
quadrantChart title 競品定位矩陣 x-axis 低複雜度 --> 高複雜度 y-axis 低市場需求 --> 高市場需求 quadrant-1 明星產品 quadrant-2 潛力股 quadrant-3 邊緣產品 quadrant-4 現金牛 "{本專案}": [{x}, {y}] "{競品A}": [{x}, {y}] "{競品B}": [{x}, {y}]
---
# 🏗️ LAYER 2: Architecture Story
> 預計閱讀時間:30-60 分鐘
---
## 3. 🎬 How It Works(專案如何運作)
### 核心流程敘事
**一句話版本**:
> 用戶 {觸發方式} → 系統 {處理流程} → 產生 {最終結果}
**詳細說明**:
{2-3 段話描述專案核心運作邏輯}
### 主要使用場景
#### 場景 1: {場景名稱}
sequenceDiagram actor User participant Frontend participant API participant Service participant DB
Note over User,DB: {場景描述} User->>Frontend: 1. {動作} Frontend->>API: 2. {API 呼叫} API->>Service: 3. {處理} Service->>DB: 4. {資料操作} DB-->>Service: 5. {回傳} Service-->>API: 6. {結果} API-->>Frontend: 7. {回應} Frontend-->>User: 8. {展示}
#### 場景 2: {場景名稱}
sequenceDiagram {類似格式}
### 關鍵程式碼入口點
| 階段 | 檔案位置 | 函數/類別 | 職責 |
|------|----------|-----------|------|
| 🚪 入口 | `{file}:{line}` | `{function}` | {說明} |
| 🛣️ 路由 | `{file}:{line}` | `{function}` | {說明} |
| ⚙️ 邏輯 | `{file}:{line}` | `{function}` | {說明} |
| 💾 資料 | `{file}:{line}` | `{class}` | {說明} |
### 核心演算法/邏輯
**{演算法名稱}**
用途:{解決什麼問題}
虛擬碼: 1. {步驟 1} 2. {步驟 2} 3. {步驟 3}
實際程式碼位置:`{file}:{start_line}-{end_line}`
---
## 4. Project Overview
### 基本資訊
| 項目 | 內容 |
|------|------|
| 專案名稱 | {name} |
| 描述 | {description} |
| 主要語言 | {language} ({percentage}%) |
| 程式碼行數 | {total_loc} |
| 授權 | {license} |
| 建立時間 | {created_at} |
| 最後更新 | {updated_at} |
| GitHub Stars | {stars} |
| Contributors | {contributors_count} |
### 技術棧摘要
| 類別 | 技術 | 版本 |
|------|------|------|
| 程式語言 | {languages} | {versions} |
| 框架 | {frameworks} | {versions} |
| 建置工具 | {build_tools} | {versions} |
| 測試框架 | {test_frameworks} | {versions} |
| 資料庫 | {databases} | {versions} |
| 基礎設施 | {infra} | - |
### 專案生命週期階段
flowchart LR A[🌱 初創] --> B[📈 成長] B --> C[🏢 成熟] C --> D[🔧 維護] D --> E[📉 衰退]
style {current_stage} fill:#4CAF50,color:#fff
**當前階段**: {stage_name}
**判斷依據**: {stage_reason}
---
## 5. Architecture Analysis
### 5.1 System Context Diagram (C4 Level 1)
> **圖表說明**:{2-3 句話解釋這張圖在說什麼}
C4Context title System Context Diagram - {專案名稱}
Person(user, "終端使用者", "使用系統的主要角色") Person(admin, "管理員", "系統管理者")
System(system, "{專案名稱}", "核心系統描述")
System_Ext(ext1, "外部系統 1", "第三方服務") System_Ext(ext2, "外部系統 2", "資料來源")
Rel(user, system, "使用") Rel(admin, system, "管理") Rel(system, ext1, "整合", "API") Rel(system, ext2, "讀取", "HTTP")
### 5.2 Container Diagram (C4 Level 2)
> **圖表說明**:{2-3 句話解釋這張圖在說什麼}
C4Container title Container Diagram - {專案名稱}
Person(user, "使用者")
System_Boundary(system, "{專案名稱}") { Container(web, "Web Application", "React/Vue", "使用者介面") Container(api, "API Server", "Node.js/Python", "業務邏輯處理") Container(worker, "Background Worker", "同技術棧", "非同步任務處理") ContainerDb(db, "Database", "PostgreSQL", "持久化儲存") ContainerDb(cache, "Cache", "Redis", "快取層") }
Rel(user, web, "使用", "HTTPS") Rel(web, api, "呼叫", "REST/GraphQL") Rel(api, db, "讀寫") Rel(api, cache, "快取") Rel(api, worker, "派發任務", "Message Queue")
### 5.3 Component Diagram (C4 Level 3)
> **圖表說明**:{2-3 句話解釋這張圖在說什麼}
C4Component title Component Diagram - API Server
Container_Boundary(api, "API Server") { Component(routes, "Routes/Controllers", "處理 HTTP 請求") Component(services, "Services", "業務邏輯") Component(repos, "Repositories", "資料存取") Component(models, "Models", "資料模型") Component(utils, "Utilities", "共用工具") }
Rel(routes, services, "呼叫") Rel(services, repos, "使用") Rel(repos, models, "操作") Rel(services, utils, "使用")
### 5.4 架構模式識別
**主要架構模式**: {pattern_name}
| 模式 | 說明 | 符合度 |
|------|------|--------|
| {pattern1} | {description} | ✅ 高 |
| {pattern2} | {description} | ⚠️ 部分 |
| {pattern3} | {description} | ❌ 無 |
### 5.5 主要元件與職責
| 元件 | 路徑 | 職責 | 依賴 |
|------|------|------|------|
| {component1} | `src/{path}` | {responsibility} | {deps} |
| {component2} | `src/{path}` | {responsibility} | {deps} |
### 5.6 技術選型分析 🆕
> **為什麼選這些技術?**
| 技術 | 選擇 | 為什麼選它 | 替代方案 |
|------|------|------------|----------|
| 語言 | {lang} | {reason} | {alternatives} |
| 框架 | {framework} | {reason} | {alternatives} |
| 資料庫 | {db} | {reason} | {alternatives} |
| 部署 | {deploy} | {reason} | {alternatives} |
### 5.7 架構決策記錄 (ADR) 推測
| ADR | 決策 | 可能原因 | 影響 |
|-----|------|----------|------|
| ADR-001 | 選用 {framework} | {reason} | {impact} |
| ADR-002 | 採用 {pattern} | {reason} | {impact} |
### 5.8 目錄結構
{專案名稱}/ ├── src/ # 原始碼 │ ├── components/ # UI 元件 │ ├── services/ # 業務邏輯 │ ├── models/ # 資料模型 │ └── utils/ # 工具函數 ├── tests/ # 測試 ├── docs/ # 文件 ├── config/ # 配置 └── package.json # 套件管理
---
## 6. Quality Assessment
### 6.1 八維度雷達圖
%%{init: {'theme': 'base'}}%% pie showData title Quality Dimensions Distribution "可維護性" : {score1} "可測試性" : {score2} "可擴展性" : {score3} "安全性" : {score4} "文件完整度" : {score5} "架構健康度" : {score6} "依賴健康度" : {score7} "開發者體驗" : {score8}
### 6.2 各維度詳細評分
#### 6.2.1 可維護性 ({score1}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 程式碼複雜度 | {sub_score} | Cyclomatic Complexity 平均值 |
| 命名規範 | {sub_score} | 一致性與可讀性 |
| 模組化程度 | {sub_score} | 單一職責原則遵守 |
| 重複程式碼 | {sub_score} | DRY 原則遵守 |
**優勢**: {strengths}
**風險**: {risks}
#### 6.2.2 可測試性 ({score2}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 測試覆蓋率 | {coverage}% | 程式碼覆蓋百分比 |
| 測試品質 | {sub_score} | 測試案例有效性 |
| Mock 使用 | {sub_score} | 依賴隔離程度 |
#### 6.2.3 可擴展性 ({score3}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 架構彈性 | {sub_score} | 新增功能的難易度 |
| 水平擴展 | {sub_score} | 多實例部署能力 |
| 設計模式 | {sub_score} | 擴展性模式使用 |
#### 6.2.4 安全性 ({score4}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 依賴漏洞 | {sub_score} | CVE 數量與嚴重度 |
| 敏感資訊 | {sub_score} | 暴露風險 |
| 輸入驗證 | {sub_score} | 注入攻擊防護 |
#### 6.2.5 文件完整度 ({score5}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| README | {sub_score} | 專案說明品質 |
| API 文件 | {sub_score} | 介面文件 |
| 程式碼註解 | {sub_score} | 內部文件 |
#### 6.2.6 架構健康度 ({score6}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| SOLID 合規 | {sub_score} | 設計原則遵守 |
| 關注點分離 | {sub_score} | 層次清晰度 |
| 依賴方向 | {sub_score} | 依賴規則遵守 |
#### 6.2.7 依賴健康度 ({score7}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 依賴數量 | {sub_score} | 直接依賴數 |
| 版本更新 | {sub_score} | 過時依賴比例 |
| 循環依賴 | {sub_score} | 循環依賴數量 |
#### 6.2.8 開發者體驗 ({score8}/100)
| 指標 | 評分 | 說明 |
|------|------|------|
| 上手難度 | {sub_score} | 新人 onboarding 時間 |
| 開發工具 | {sub_score} | 工具配置完整性 |
| 錯誤訊息 | {sub_score} | 錯誤可讀性 |
### 6.3 優勢與風險摘要
#### 優勢 ✅
1. {strength1}
2. {strength2}
3. {strength3}
#### 風險 ⚠️
1. {risk1}
2. {risk2}
3. {risk3}
---
## 7. Value & Competitive Analysis
### 7.1 專案解決的問題
| 問題 | 痛點程度 | 現有解決方案 | 本專案優勢 |
|------|----------|--------------|------------|
| {problem1} | 🔴 高 | {alternatives} | {advantage} |
| {problem2} | 🟠 中 | {alternatives} | {advantage} |
### 7.2 獨特價值主張 (UVP)
> **「{一句話 UVP}」**
核心價值:
1. **{value1}** — {description}
2. **{value2}** — {description}
3. **{value3}** — {description}
### 7.3 不可替代性評估
| 維度 | 評分 | 說明 |
|------|------|------|
| 技術獨特性 | ★★★★☆ | {說明} |
| 生態整合深度 | ★★★☆☆ | {說明} |
| 遷移成本 | ★★★★☆ | {說明} |
| 學習曲線 | ★★★☆☆ | {說明} |
| 社群活躍度 | ★★★★★ | {說明} |
**綜合不可替代性分數:{X.X}/5**
### 7.4 競品比較矩陣
> **詳細比較 3-6 個主要競品/替代方案**
| 維度 | 本專案 | {競品A} | {競品B} | {競品C} |
|------|--------|---------|---------|---------|
| **核心功能** | {描述} | {描述} | {描述} | {描述} |
| **技術架構** | {描述} | {描述} | {描述} | {描述} |
| **擴展性** | ✅ 插件系統 | ⚠️ 有限 | ❌ 無 | ✅ 完整 |
| **學習曲線** | 🟡 中等 | 🟢 低 | 🔴 高 | 🟡 中等 |
| **社群活躍度** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
| **授權方式** | MIT | Apache-2.0 | GPL-3.0 | 商業 |
| **最後更新** | {日期} | {日期} | {日期} | {日期} |
**選擇建議**:
- 選 **本專案** 如果:{適用場景}
- 選 **{競品A}** 如果:{適用場景}
- 選 **{競品B}** 如果:{適用場景}
### 7.5 適用場景分析
> **用餅圖呈現最適合的使用場景佔比**
pie title 最適合使用場景 "{場景A}" : 35 "{場景B}" : 30 "{場景C}" : 20 "{場景D}" : 15
**場景說明**:
| 場景 | 推薦指數 | 說明 |
|------|----------|------|
| {場景A} | ⭐⭐⭐⭐⭐ | {為什麼特別適合} |
| {場景B} | ⭐⭐⭐⭐ | {為什麼適合} |
| {場景C} | ⭐⭐⭐ | {條件限制} |
| {場景D} | ⭐⭐ | {注意事項} |
**採用建議矩陣**:
| 你的情況 | 建議 | 原因 |
|----------|------|------|
| {情況1} | 🟢 強烈推薦 | {原因} |
| {情況2} | 🟡 謹慎考慮 | {原因} |
| {情況3} | 🔴 不建議 | {原因} |
### 7.6 版本演進分析
> **如果專案有 CHANGELOG 或 Git 歷史,分析版本演進**
#### 版本時間軸
gantt title 專案版本演進 dateFormat YYYY-MM-DD section 主要版本 v1.0 Initial Release :done, v1, 2024-01-01, 30d v2.0 Major Rewrite :done, v2, 2024-02-01, 60d v3.0 Current :active, v3, 2024-04-01, 90d section 里程碑 Core Features Complete :milestone, m1, 2024-01-30, 0d Production Ready :milestone, m2, 2024-03-31, 0d
#### 關鍵版本里程碑
| 版本 | 日期 | 重點功能 | 影響 |
|------|------|----------|------|
| v1.0 | {日期} | {功能描述} | 🌱 奠定基礎 |
| v2.0 | {日期} | {功能描述} | 📈 重大改進 |
| v3.0 | {日期} | {功能描述} | 🚀 當前穩定版 |
#### 演進趨勢分析
- **開發活躍度**:{高/中/低},過去 6 個月有 {N} 次提交
- **版本頻率**:平均每 {N} 週發布一個版本
- **Breaking Changes**:過去 {N} 個版本有 {M} 次破壞性變更
- **未來方向**:根據 Issues/Roadmap,預計 {方向描述}
---
# 🔬 LAYER 3: Deep Dive Reference
> 按需查閱,包含具體程式碼位置與可執行建議
---
## 8. Technical Debt Report
### 8.1 債務總覽
| 類別 | 項目數 | 估計修復時間 | 風險等級 |
|------|--------|--------------|----------|
| 可靠性債務 | {count} | {days} 人天 | 🔴 |
| 安全性債務 | {count} | {days} 人天 | 🔴 |
| 可維護性債務 | {count} | {days} 人天 | 🟠 |
| 效能債務 | {count} | {days} 人天 | 🟡 |
| 測試債務 | {count} | {days} 人天 | 🟡 |
| **總計** | **{total}** | **{total_days} 人天** | - |
### 8.2 債務明細(含程式碼位置)
#### 可靠性債務
| ID | 問題 | 位置 | 風險 | 修復時間 |
|----|------|------|------|----------|
| TD-001 | {issue} | `{file}:{line}` | 🔴 | {hours}h |
#### 安全性債務
| ID | 問題 | 位置 | 風險 | 修復時間 |
|----|------|------|------|----------|
| TD-002 | {issue} | `{file}:{line}` | 🔴 | {hours}h |
#### 可維護性債務
| ID | 問題 | 位置 | 風險 | 修復時間 |
|----|------|------|------|----------|
| TD-003 | {issue} | `{file}:{line}` | 🟠 | {hours}h |
### 8.3 優先級矩陣
quadrantChart title Technical Debt Priority x-axis Low Effort --> High Effort y-axis Low Impact --> High Impact quadrant-1 Quick Wins quadrant-2 Major Projects quadrant-3 Fill-ins quadrant-4 Thankless Tasks TD-001: [0.8, 0.9] TD-002: [0.3, 0.8] TD-003: [0.5, 0.5]
---
## 9. Dependency Analysis
### 9.1 依賴總覽
| 類型 | 數量 |
|------|------|
| 直接依賴 | {direct_count} |
| 間接依賴 | {transitive_count} |
| 開發依賴 | {dev_count} |
| **總計** | **{total_count}** |
### 9.2 模組依賴圖
flowchart LR subgraph Core["核心模組"] A["{module1}"] B["{module2}"] end
subgraph Services["服務層"] C["{service1}"] D["{service2}"] end
subgraph Data["資料層"] E["{repo1}"] end
A --> C B --> C C --> E D --> E
%% 循環依賴警告 %% C -.->|⚠️ 循環| A
### 9.3 依賴健康檢查
| 套件 | 當前版本 | 最新版本 | 狀態 | 風險 |
|------|----------|----------|------|------|
| {package1} | {current} | {latest} | 🔴 CVE | Critical |
| {package2} | {current} | {latest} | 🟠 落後 2+ 版 | High |
| {package3} | {current} | {latest} | 🟡 小版本落後 | Medium |
| {package4} | {current} | {latest} | ✅ 最新 | None |
### 9.4 循環依賴警告
| 循環路徑 | 影響 | 建議 |
|----------|------|------|
| A → B → C → A | {impact} | {suggestion} |
### 9.5 授權合規檢查
| 授權類型 | 套件數 | 合規風險 |
|----------|--------|----------|
| MIT | {count} | ✅ 無 |
| Apache-2.0 | {count} | ✅ 無 |
| GPL-3.0 | {count} | ⚠️ 可能傳染 |
| 未知 | {count} | 🔴 需確認 |
---
## 10. Security Assessment
### 10.1 安全分數:{score}/100
### 10.2 漏洞掃描摘要
| 嚴重度 | 數量 | 範例 |
|--------|------|------|
| 🔴 Critical | {count} | {example} |
| 🟠 High | {count} | {example} |
| 🟡 Medium | {count} | {example} |
| 🟢 Low | {count} | {example} |
### 10.3 OWASP Top 10 檢查
| 風險 | 狀態 | 說明 |
|------|------|------|
| A01:2021 Broken Access Control | ✅/⚠️/🔴 | {detail} |
| A02:2021 Cryptographic Failures | ✅/⚠️/🔴 | {detail} |
| A03:2021 Injection | ✅/⚠️/🔴 | {detail} |
| A04:2021 Insecure Design | ✅/⚠️/🔴 | {detail} |
| A05:2021 Security Misconfiguration | ✅/⚠️/🔴 | {detail} |
| A06:2021 Vulnerable Components | ✅/⚠️/🔴 | {detail} |
| A07:2021 Authentication Failures | ✅/⚠️/🔴 | {detail} |
| A08:2021 Software and Data Integrity | ✅/⚠️/🔴 | {detail} |
| A09:2021 Logging Failures | ✅/⚠️/🔴 | {detail} |
| A10:2021 SSRF | ✅/⚠️/🔴 | {detail} |
### 10.4 敏感資訊檢查
| 類型 | 位置 | 風險 | 建議 |
|------|------|------|------|
| API Key 暴露 | `{file}` | 🔴 | 移至環境變數 |
| 硬編碼密碼 | `{file}` | 🔴 | 使用密鑰管理 |
---
## 11. 🛠️ Actionable Recommendations(可執行建議)
> **每項建議都包含:問題位置 → 問題程式碼 → 修復範例 → 驗證步驟**
### 11.1 建議摘要表
| ID | 標題 | 類別 | 重要性 | 優先級 | 問題位置 |
|----|------|------|--------|--------|----------|
| REC-001 | {title} | Security | ⭐⭐⭐ | 🔴 | `{file}:{line}` |
| REC-002 | {title} | Architecture | ⭐⭐⭐ | 🟠 | `{file}:{line}` |
| REC-003 | {title} | Performance | ⭐⭐ | 🟡 | `{file}:{line}` |
| REC-004 | {title} | Quality | ⭐ | 🟢 | `{file}:{line}` |
### 11.2 優先級矩陣
quadrantChart title Recommendations Priority Matrix x-axis 低緊迫性 --> 高緊迫性 y-axis 低重要性 --> 高重要性 quadrant-1 Strategic quadrant-2 Critical quadrant-3 Optional quadrant-4 Quick Wins "REC-001": [0.9, 0.9] "REC-002": [0.7, 0.8] "REC-003": [0.4, 0.5] "REC-004": [0.2, 0.3]
---
### 🔴 立即處理
#### REC-001: {標題}
| 屬性 | 值 |
|------|-----|
| 類別 | 🔒 Security |
| 重要性 | ⭐⭐⭐ 核心 |
| 優先級 | 🔴 Critical |
##### 📍 問題位置
- `{file1}:{line1}`
- `{file2}:{line2}`
##### ❌ 問題程式碼// {file}:{line} {problematic_code} // ^^^^^^^^^ {問題說明}
##### ✅ 修復範例// {file}:{line} {fixed_code}
##### 🧪 驗證步驟1. {步驟說明}
{command1}
2. {步驟說明}
{command2}
預期結果:{expected}
##### ✓ 成功指標
- [ ] {指標 1}
- [ ] {指標 2}
---
### 🟠 短期處理
#### REC-002: {標題}
{同上格式...}
---
### 🟡 規劃處理
#### REC-003: {標題}
{同上格式...}
---
### 🟢 適時處理
#### REC-004: {標題}
{同上格式...}
---
## 12. Appendix(附錄)
### A. 完整目錄結構
{詳細目錄結構}
### B. 關鍵檔案清單
| 檔案 | 用途 | 重要性 |
|------|------|--------|
| `{file1}` | {purpose} | ⭐⭐⭐ |
| `{file2}` | {purpose} | ⭐⭐ |
### C. 術語表
| 術語 | 定義 |
|------|------|
| {term1} | {definition} |
| {term2} | {definition} |
### D. 分析方法說明
本報告採用以下分析框架:
- **架構文件**: [arc42](https://arc42.org/) + [C4 Model](https://c4model.com/)
- **技術債務**: [SQALE](https://www.sqale.org/) 方法
- **安全評估**: [OWASP Top 10](https://owasp.org/www-project-top-ten/)
- **品質評估**: 自訂 8 維度模型
### E. 分數條生成參考
█ = 10 分 ░ = 空位
100/100 = ██████████ 90/100 = █████████░ 80/100 = ████████░░ 70/100 = ███████░░░ 60/100 = ██████░░░░ 50/100 = █████░░░░░
---
*此報告由 Claude Code analyze-repo Skill v3.0 自動產生*
*分析日期: {YYYY-MM-DD}*Mermaid 圖表範例集
C4 Context Diagram 範例
C4Context
title System Context Diagram - E-Commerce Platform
Person(customer, "Customer", "購買商品的終端用戶")
Person(admin, "Admin", "平台管理員")
System(ecommerce, "E-Commerce Platform", "線上購物平台")
System_Ext(payment, "Payment Gateway", "第三方支付")
System_Ext(shipping, "Shipping Service", "物流服務")
System_Ext(email, "Email Service", "郵件通知")
Rel(customer, ecommerce, "瀏覽、購買", "HTTPS")
Rel(admin, ecommerce, "管理", "HTTPS")
Rel(ecommerce, payment, "處理付款", "API")
Rel(ecommerce, shipping, "建立訂單", "API")
Rel(ecommerce, email, "發送通知", "SMTP")Quality Radar Chart Alternative
pie showData
title Quality Assessment
"Maintainability (85)" : 85
"Testability (70)" : 70
"Scalability (75)" : 75
"Security (60)" : 60
"Documentation (50)" : 50
"Architecture (80)" : 80
"Dependencies (65)" : 65
"DX (72)" : 72Technical Debt Trend
xychart-beta
title "Technical Debt Trend"
x-axis ["Q1", "Q2", "Q3", "Q4"]
y-axis "Debt (person-days)" 0 --> 100
bar [30, 45, 60, 80]
line [30, 45, 60, 80]Dependency Graph
flowchart TB
subgraph Frontend
UI[UI Components]
State[State Management]
Router[Router]
end
subgraph Backend
API[API Layer]
Service[Service Layer]
Repository[Repository]
end
subgraph Infrastructure
DB[(Database)]
Cache[(Redis)]
Queue[Message Queue]
end
UI --> State
UI --> Router
State --> API
API --> Service
Service --> Repository
Service --> Cache
Service --> Queue
Repository --> DB
classDef warning fill:#ff9800,color:#fff
classDef danger fill:#f44336,color:#fffanalyze-repo Skill v2.0
企業級專案深度分析工具 — 從程式碼到商業價值的完整洞察
解決的問題
你是否曾遇到這些困境?
| 角色 | 痛點 |
|---|---|
| 新進工程師 | 接手專案卻不知從何下手,文件過時或根本不存在 |
| 技術主管 | 需要快速評估技術債務和風險,卻沒有客觀指標 |
| 架構師 | 想了解系統全貌,卻只能靠人工閱讀數萬行程式碼 |
| 投資人/PM | 需要評估專案價值,但技術細節太過複雜 |
| 面試官 | 想評估候選人的 Side Project,但時間有限 |
傳統方式的問題
- 耗時:手動分析一個中型專案需要數天甚至數週
- 主觀:不同人的評估標準不一致,難以比較
- 不完整:容易遺漏安全性、依賴健康度等重要面向
- 缺乏商業視角:技術報告無法轉化為商業決策
目標與價值
核心目標
在 10 分鐘內,產出一份專業級的專案分析報告
這份報告能讓:
- 工程師快速上手專案
- 主管做出技術決策
- 投資人評估技術價值
- 團隊識別風險和改善方向
提供的價值
| 價值 | 說明 |
|---|---|
| 節省時間 | 將數天的人工分析壓縮到 10 分鐘 |
| 客觀評估 | 8 維度量化指標,消除主觀偏見 |
| 全面覆蓋 | 從程式碼品質到市場價值,一次到位 |
| 可行建議 | 不只指出問題,更提供解決方案和優先順序 |
| 多角色適用 | 同一份報告,不同視角閱讀 |
核心特色
| 特色 | 說明 |
|---|---|
| arc42 + C4 架構 | 業界標準軟體架構文件 + 四層視覺化 |
| 8 維度品質評估 | 可維護性、可測試性、可擴展性、安全性、文件、架構、依賴、DX |
| 技術債務量化 | SQALE 模型 + 修復時間估算 + 優先級矩陣 |
| 安全性評估 | OWASP Top 10 + 依賴漏洞掃描 + 敏感資訊檢測 |
| 市場價值分析 | TAM/SAM/SOM + 技術趨勢對齊 + SWOT + 投資建議 |
| 多視角報告 | Executive / Architect / Developer / Investor |
誰適合使用?
| 角色 | 使用情境 | 推薦視角 |
|---|---|---|
| Executive | 快速了解專案狀況、風險和投資價值 | --perspective=executive |
| Architect | 深入分析架構設計、技術債務、改善路線圖 | --perspective=architect |
| Developer | 快速上手專案、了解程式碼結構和開發流程 | --perspective=developer |
| Investor | Due Diligence、技術資產估值、競品分析 | --perspective=investor |
使用方式
# 分析當前目錄
/analyze-repo .
# 分析 GitHub 專案
/analyze-repo https://github.com/owner/repo
# 分析本地路徑
/analyze-repo /path/to/project
# 指定視角
/analyze-repo . --perspective=executive # 高層摘要
/analyze-repo . --perspective=architect # 架構深度分析
/analyze-repo . --perspective=developer # 開發者上手指南
/analyze-repo . --perspective=investor # Due Diligence 報告
/analyze-repo . --perspective=full # 完整報告(預設)報告結構
完整報告包含 11 個主要區塊:
1. Executive Summary
└── 一句話定位 + 健康分數 + 關鍵發現 + 立即行動
2. Project Overview
└── 基本資訊 + 技術棧 + 生命週期階段
3. Architecture Analysis (C4 Model)
├── Level 1: System Context
├── Level 2: Container
├── Level 3: Component
└── Level 4: Code(選擇性)
4. Quality Assessment (8 維度)
├── 可維護性 / 可測試性 / 可擴展性 / 安全性
└── 文件完整度 / 架構健康度 / 依賴健康度 / DX
5. Technical Debt Report
└── SQALE 分類 + 量化估算 + 優先級矩陣
6. Dependency Analysis
└── 依賴圖譜 + 健康檢查 + 循環依賴 + 授權合規
7. Security Assessment
└── 漏洞掃描 + OWASP Top 10 + 敏感資訊
8. Value & Competitive Analysis
└── UVP + 不可替代性 + 競品比較 + 採用建議
9. Market Future Value Analysis
└── 技術趨勢對齊 + TAM/SAM/SOM + SWOT + 投資建議
10. Strategic Recommendations
└── 優先級矩陣 + 時間軸路線圖 + 詳細建議
11. Appendix
└── 目錄結構 + 關鍵檔案 + 術語表 + 方法說明評估框架
8 維度品質評估(1-100 分)
| 維度 | 權重 | 回答的問題 | 評估標準 |
|---|---|---|---|
| 可維護性 | 15% | 程式碼好不好改? | 複雜度、命名、模組化、Maintainability Index |
| 可測試性 | 12% | 測試覆蓋率夠嗎? | 覆蓋率、測試品質、Mock 使用 |
| 可擴展性 | 12% | 能撐住 10 倍流量嗎? | 架構彈性、水平擴展、設計模式 |
| 安全性 | 15% | 有沒有安全漏洞? | 依賴漏洞、敏感資訊、OWASP |
| 文件完整度 | 10% | 新人能看懂嗎? | README、API 文件、註解 |
| 架構健康度 | 15% | 設計有沒有問題? | SOLID、關注點分離、依賴方向 |
| 依賴健康度 | 11% | 依賴穩定嗎? | 數量、版本、循環依賴 |
| 開發者體驗 | 10% | 開發順不順手? | 上手難度、工具配置、錯誤訊息 |
技術債務分類(SQALE 模型)
| 類別 | 偵測指標 |
|---|---|
| 可靠性債務 | 未處理例外、空指標、資源洩漏 |
| 安全性債務 | 已知漏洞、硬編碼密鑰、注入風險 |
| 可維護性債務 | 重複程式碼、過長函數、過深巢狀 |
| 效能債務 | N+1 查詢、無快取、同步阻塞 |
| 測試債務 | 低覆蓋率、無整合測試、脆弱測試 |
建議優先級框架
重要性(對專案的長期影響):
| 重要性 | 說明 |
|---|---|
| ⭐⭐⭐ 核心/必要 | 不做會導致專案失敗或嚴重風險 |
| ⭐⭐ 重要/建議 | 顯著提升品質或降低風險 |
| ⭐ 可選/增強 | 錦上添花,提升體驗 |
優先級(何時執行):
| 優先級 | 時間軸 |
|---|---|
| 🔴 Critical | 立即(本週內) |
| 🟠 High | 短期(1-3 個月) |
| 🟡 Medium | 中期(3-6 個月) |
| 🟢 Low | 長期(6-12 個月) |
檔案結構
analyze-repo/
├── SKILL.md # 核心 Skill 定義
├── README.md # 本文件
└── extended/
└── output-template.md # 完整輸出模板v2.0 更新記錄
| 項目 | v1.0 | v2.0 |
|---|---|---|
| 架構標準 | 自訂 | arc42 + C4 Model |
| 品質維度 | 5 維度 | 8 維度 |
| 技術債務 | 簡單列表 | SQALE 量化 |
| 安全評估 | 基本檢查 | OWASP Top 10 |
| 市場分析 | 競品比較 | TAM/SAM/SOM + SWOT |
| 建議系統 | 優先級 | 重要性 + 優先級 + 路線圖 |
| 輸出格式 | 6 區塊 | 11 區塊 |
採用的業界標準
| 標準 | 用途 |
|---|---|
| arc42 | 軟體架構文件標準 |
| C4 Model | 架構視覺化方法 |
| SQALE | 技術債務量化 |
| OWASP Top 10 | Web 安全風險 |
相關 Skill
- /evolve — 自主完成複雜目標
- /commit — 提交程式碼變更
- /code-review — 深度程式碼審查
安裝
方式 1:Claude Code Plugin Marketplace(推薦)
/install plugin:claude-software-skills方式 2:手動安裝
cp -r tools-integrations/analyze-repo ~/.claude/skills/授權
MIT License