القائمة
GitLab 開發者評估與分析技能。分析單一開發者、多位開發者或所有開發者的程式碼品質、commit 記錄、專案參與度、技術能力。支援時間區間篩選（過去一個月、三個月等）、專案範圍篩選（特定專案或全專案）。使用 gl-cli.py 工具產生綜合評估報告，包含 6 大維度評分、改善建議與學習方向。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | developer-assessment |
| description | GitLab 開發者評估與分析技能。分析單一開發者、多位開發者或所有開發者的程式碼品質、commit 記錄、專案參與度、技術能力。支援時間區間篩選（過去一個月、三個月等）、專案範圍篩選（特定專案或全專案）。使用 gl-cli.py 工具產生綜合評估報告，包含 6 大維度評分、改善建議與學習方向。 |
| globs | ["**/*.py","**/*.md","**/scripts/**","**/開發者評估報告*.md"] |
GitLab 開發者評估與分析專家，透過 gl-cli.py 工具深度分析開發者在 GitLab 上的活動與貢獻，提供多維度的技術能力評估。
本 Skill 專門處理開發者評估相關的任務，支援以下使用場景：
分析開發者 en20241119分析開發者 en20241119、G2023018、alice分析所有開發者彙整所有開發者的評估報告# 範例 1：單一開發者的完整評估
分析開發者 en20241119，過去一個月在「新求才WebVue」專案的完整評估
# 範例 2：多位開發者的比較分析
分析開發者 en20241119、G2023018，過去三個月的完整評估
# 範例 3：全體開發者的團隊分析
分析所有開發者，過去一個月的完整評估
# 範例 4：特定維度評估
分析開發者 alice 的程式碼品質和 commit 規範
# 範例 5：跨專案比較
分析開發者 bob 在所有專案的技術能力評估
# 範例 6：彙整所有評估報告
彙整所有開發者的評估報告成一份摘要表格
互動式需求確認
資料收集流程 (詳見 gl-cli.py 完整操作手冊)
標準工作流程：
Step 1: 執行 gl-cli.py user-details 收集開發者資料
↓
Step 2: 掃描 .\scripts\output\users\{username}\ 目錄下所有 CSV 檔案
↓
Step 3: 分析各項 CSV 檔案（commits, code_changes, merge_requests, code_reviews 等）
↓
Step 4: 產生評估報告並儲存為 analysis-result.md
⚠️ 重要：
gl-cli.py user-details 取得開發者詳細資訊（commits, code changes, MRs, reviews）.\scripts\output\ （不要使用 --output 參數）{username}-index.md 可能不完整！
ls 或 glob 列出 .\scripts\output\users\{username}\*.csv 所有檔案多維度評估 (詳見 程式碼品質評估規範)
依據 6 大評估維度 進行分析（總分 100 分）：
| 維度 | 權重 | 主要指標 | 資料來源 |
|---|---|---|---|
| 程式碼貢獻量 | 12% | 提交次數、活躍度、產出量 | statistics.csv, commits.csv |
| Commit 品質 | 23% | Message 規範、變更粒度、修復率 | commits.csv, code_changes.csv |
| 技術廣度與深度 | 18% | 語言分布、檔案類型、技術棧 | code_changes.csv, statistics.csv |
| 協作能力 | 12% | Merge Commits、衝突處理、Revert 率 | merge_requests.csv, commits.csv |
| Code Review 品質 | 10% | Review 參與度、深度、時效性 | code_reviews.csv, merge_requests.csv |
| 工作模式與效率 | 10% | 時間分布、穩定性 | commits.csv (created_at) |
| 進步趨勢 | 15% | 成長曲線、技能提升 | 時間序列對比 |
詳細評估方法請參考：code-quality-analysis-spec.md
報告產生
.\scripts\output\users\{username}\analysis-result.md彙整評估報告 (詳見 彙整報告規範)
.\scripts\output\users\*\analysis-result.md 所有評估報告.\scripts\output\users\all-user-analysis-result.md直接在對話中使用自然語言描述您的評估需求，本 Skill 會自動被觸發：
分析開發者 en20241119，過去一個月在「新求才WebVue」專案的完整評估
執行流程：
gl-cli.py user-details --username en20241119 --project-name "新求才WebVue" --start-date 2024-12-21 --end-date 2026-01-21分析開發者 en20241119、G2023018，過去一個月在「新求才WebVue」專案的完整評估
執行流程：
分析所有開發者，過去一個月的完整評估
執行流程：
分析開發者 alice 的程式碼品質和 commit 規範
執行流程：
本 Skill 會根據以下關鍵字模式自動觸發：
| 觸發模式 | 範例 | 說明 |
|---|---|---|
| 分析開發者 + 名稱 | 分析開發者 en20241119 | 單一開發者評估 |
| 分析開發者 + 多個名稱 | 分析開發者 alice、bob、carol | 多位開發者比較 |
| 分析所有開發者 | 分析所有開發者過去三個月 | 全體團隊分析 |
| 彙整評估報告 | 彙整所有開發者的評估報告 | 產生摘要表格 |
| 過去 X 個月/週 | 過去一個月、過去三個月 | 相對時間範圍 |
| 在「專案名稱」專案 | 在「新求才WebVue」專案 | 特定專案範圍 |
| 完整評估 | 完整評估、綜合評估 | 6 大維度完整分析 |
| 特定維度 | 程式碼品質、協作能力 | 單一維度深度分析 |
當使用者輸入的資訊不完整時，本 Skill 會主動詢問：
使用者：分析開發者 alice
↓
Skill：請問您要分析的時間範圍？
1. 過去一個月
2. 過去三個月
3. 過去半年
4. 自訂時間範圍
↓
使用者：選擇 1
↓
Skill：請問要分析哪些專案？
1. 所有專案
2. 指定專案（請提供專案名稱）
↓
使用者：選擇 2，專案名稱「新求才WebVue」
↓
Skill：開始執行評估...
📚 完整操作手冊: gl-cli.py 使用指南 - 包含所有命令、參數說明與範例
步驟 1：執行資料收集命令
執行 gl-cli.py user-details 時，不要使用 --output 參數（使用預設輸出路徑）：
cd scripts
# ✅ 正確：使用預設輸出目錄 ./output
python3 gl-cli.py user-details \
--username <開發者名稱> \
--start-date <YYYY-MM-DD> \
--end-date <YYYY-MM-DD>
# ❌ 錯誤：不要指定自訂輸出目錄
# python3 gl-cli.py user-details --username alice --output ./custom-dir
步驟 2：掃描實際 CSV 檔案
資料收集完成後，不要依賴 index.md，直接掃描目錄：
# 列出該開發者目錄下的所有 CSV 檔案
ls -lah .\scripts\output\users\<username>\*.csv
# 或使用 glob 模式
glob pattern="scripts/output/users/<username>/*.csv"
步驟 3：分析 CSV 檔案
根據目錄中實際存在的檔案進行深度分析：
statistics.csv - 統計摘要（17 個指標）commits.csv - Commit 詳細記錄code_changes.csv - 程式碼異動詳情merge_requests.csv - MR 記錄code_reviews.csv - Code Review 評論步驟 4：產生評估報告
依據 程式碼品質評估規範 產生報告，並儲存為：
.\scripts\output\users\<username>\analysis-result.md
重要原因：
.\scripts\output\users\{username}\# 環境設定
cd scripts
# ⭐ 主要命令：取得開發者詳細資訊（推薦使用）
python3 gl-cli.py user-details \
--username <開發者名稱> \
--project-name <專案名稱> \
--start-date <YYYY-MM-DD> \
--end-date <YYYY-MM-DD>
# 輸出檔案結構：
# .\scripts\output\ # 預設輸出目錄（可透過 --output 參數自訂）
# ├── users\ # 開發者資料目錄
# │ └── {username}\ # 每位開發者獨立目錄
# │ ├── {username}-index.md # 索引檔案（資料摘要與檔案清單）
# │ ├── user_profile.csv # 使用者基本資料 (30+ 欄位)
# │ ├── user_events.csv # 活動事件追蹤
# │ ├── commits.csv # Commit 詳細記錄
# │ ├── code_changes.csv # 程式碼異動詳情（file-level diffs）
# │ ├── merge_requests.csv # MR 記錄
# │ ├── code_reviews.csv # Code Review 評論
# │ ├── contributors.csv # 專案貢獻者統計
# │ ├── permissions.csv # 專案授權資訊
# │ └── statistics.csv # 統計摘要 (多項指標)
# ├── groups\ # 群組資料目錄
# │ └── {groupname}\
# │ ├── groups.csv # 群組資訊
# │ ├── subgroups.csv # 子群組列表
# │ ├── projects.csv # 專案列表
# │ ├── permissions.csv # 成員權限
# │ └── summary.csv # 群組摘要
# └── projects\ # 專案資料目錄
# └── {projectname}\
# ├── project.csv # 專案資訊
# └── permissions.csv # 專案權限
#
# 📌 CSV 檔案編碼：UTF-8 with BOM (utf-8-sig)，Excel 可直接開啟
#
# 範例：分析開發者 G2023018 在 "新求才WebVue" 專案
# → 輸出路徑：.\scripts\output\users\G2023018\commits.csv
# 取得使用者專案列表
python3 gl-cli.py user-projects \
--username <開發者名稱> \
--group-name <群組名稱> \
--output <輸出目錄> # 選填
# 取得專案詳細資訊
python3 gl-cli.py project-stats \
--project-name <專案名稱> \
--output <輸出目錄> # 選填
# 取得群組資訊
python3 gl-cli.py group-stats \
--group-name <群組名稱> \
--output <輸出目錄> # 選填
# 多位使用者同時查詢（自動啟用批次模式優化）
# 批次模式：預先載入專案清單，共用快取，顯著提升效能
python3 gl-cli.py user-details \
--username alice bob charlie \
--start-date 2024-01-01
# 多個專案同時查詢（笛卡爾積模式）
python3 gl-cli.py user-details \
--project-name "web-api" "mobile-app" "admin-panel" \
--start-date 2024-01-01
# 組合查詢：多位使用者在多個專案的活動
# 注意：多使用者 + 多專案 → 使用笛卡爾積模式（較慢）
python3 gl-cli.py user-details \
--username alice bob \
--project-name "web-api" "mobile-app" \
--start-date 2024-01-01
# 💡 效能建議：
# ✅ 推薦：多使用者 + 單一專案範圍（或不指定專案）→ 批次模式
# ⚠️ 較慢：多使用者 + 多專案 → 笛卡爾積模式
執行前需確保已安裝：
若缺少套件，引導使用者安裝：
cd scripts
source .venv/bin/activate # 如果有虛擬環境
pip install pandas openpyxl urllib3 python-gitlab
# 或使用 uv（推薦）
cd scripts && uv sync
首次使用需設定 GitLab 連線資訊：
# 複製範本
cp scripts/config-example.py scripts/config.py
# 編輯 config.py，設定以下參數：
# - GITLAB_URL: GitLab 伺服器位址
# - GITLAB_TOKEN: Personal Access Token（需要 read_api, read_repository, read_user 權限）
# - START_DATE / END_DATE: 預設分析時間範圍
# - TARGET_GROUP_ID: 預設群組 ID（可選）
詢問使用者：
分析對象
時間範圍
專案範圍
評估維度（多選）
分析流程（依據 程式碼品質評估規範）：
⚠️ 第一步：掃描目錄確認實際存在的 CSV 檔案！
# 掃描使用者目錄下的所有 CSV 檔案
ls -lah ./output/users/<username>/*.csv
# 或使用更友善的顯示方式
find ./output/users/<username>/ -name "*.csv" -type f -printf "%f\n"
從目錄掃描結果確認：
資料來源：statistics.csv、commits.csv
分析指標：
評分標準：
分析命令：
# 讀取統計摘要
cat ./output/users/<username>/statistics.csv | grep "commits_count\|active_days\|total_additions"
資料來源：commits.csv、code_changes.csv
分析維度：
檢查指標：
優質範例：
feat(auth): add JWT token validation
fix(api): resolve null pointer in user service
docs(readme): update installation guide
refactor(utils): extract common validation logic
劣質範例：
update
fix bug
修改
WIP
評分標準：
分析命令：
# 檢查 commits.csv 中的 message 欄位
# 統計符合 Conventional Commits 的比例
grep -E "^(feat|fix|docs|refactor|test|chore|style|perf)\(" ./output/users/<username>/commits.csv | wc -l
檢查指標：單次 commit 的程式碼變更量
黃金比例：
| 規模 | 行數 | 理想佔比 | 說明 |
|---|---|---|---|
| 小型 | ≤100 行 | 60%+ | 模組化思維好 ✅ |
| 中型 | 100-500 行 | 30% | 正常功能開發 |
| 大型 | >500 行 | <10% | 過多表示缺乏拆分能力 ⚠️ |
評分標準：
分析命令：
# 計算每次 commit 的變更量（additions + deletions）
# 統計小型/中型/大型變更的比例
cat ./output/users/<username>/commits.csv | awk -F',' '{print $additions + $deletions}'
檢查指標：包含修復關鍵字的提交比例
關鍵字：fix, bug, hotfix, revert
評分標準：
分析命令：
# 統計包含修復關鍵字的提交
grep -iE "fix|bug|hotfix|revert" ./output/users/<username>/commits.csv | wc -l
資料來源：code_changes.csv、statistics.csv
分析指標：
檔案類型對照表：
前端開發者：
.js, .ts, .jsx, .tsx → React/Vue/Angular
.css, .scss, .sass → 樣式設計
.html, .cshtml → 模板
後端開發者：
.cs → C# .NET
.java → Java Spring
.py → Python Django/Flask
.go → Golang
DevOps/SRE：
Dockerfile → 容器化
.yml, .yaml → CI/CD
.sh, .bash → 自動化腳本
.tf → Terraform (基礎設施即程式碼)
評分標準：
分析命令：
# 統計檔案類型分佈
cat ./output/users/<username>/code_changes.csv | \
awk -F',' '{print $file_path}' | \
sed 's/.*\(\.[^.]*\)$/\1/' | \
sort | uniq -c | sort -rn
資料來源：merge_requests.csv、commits.csv
分析維度：
指標：
評分標準：
分析命令：
# 查找被回退的提交
grep -i "revert" ./output/users/<username>/commits.csv | wc -l
資料來源：code_reviews.csv、merge_requests.csv
分析維度（詳見 code-quality-analysis-spec.md 第 5 節）：
指標：
評分標準：
優質 Review Comment 範例：
這裡的 SQL 查詢可能有 N+1 問題，建議改用 JOIN：
// 目前寫法（會產生 100 次查詢）
const users = await User.findAll();
for (const user of users) {
user.posts = await Post.findAll({ where: { userId: user.id } });
}
// 建議修改（只需 1 次查詢）
const users = await User.findAll({
include: [{ model: Post }]
});
劣質 Review Comment 範例：
LGTM
看起來不錯
👍
沒問題
評分標準：
發現問題的嚴重等級：
指標：平均 Review 回應時間
評分標準：
指標：
評分標準：
分析命令：
# 分析 code_reviews.csv
cat ./output/users/<username>/code_reviews.csv | \
grep -v "^discussion_id" | \
wc -l # Review Comments 總數
資料來源：commits.csv（created_at 欄位）
分析指標：
優質工作模式：
警訊模式：
分析命令：
# 分析提交時間分佈
cat ./output/users/<username>/commits.csv | \
awk -F',' '{print $created_at}' | \
awk -F'T' '{print $2}' | \
awk -F':' '{print $1}' | \
sort | uniq -c
分析方法：時間切片對比
比較維度：
分析策略：
# 將資料分為兩個時間段
# 早期表現（前 50% 資料）vs 近期表現（後 50% 資料）
# 比較各項指標的變化趨勢
總分公式（滿分 10 分）：
總分 = (貢獻量得分 × 0.12) +
(Commit 品質得分 × 0.23) +
(技術廣度得分 × 0.18) +
(協作得分 × 0.12) +
(Code Review 得分 × 0.10) +
(工作模式得分 × 0.10) +
(進步趨勢得分 × 0.15)
分級標準：
| 等級 | 分數 | 特徵描述 |
|---|---|---|
| 🏆 高級工程師 | 8-10 | • Message 規範率 90%+ • 小型變更佔比 80%+ • 涉及 3+ 技術棧 • 修復率 <15% • 有架構級別變更 • Review 參與度高，能發現 Critical Issues ⭐ |
| ⭐ 中級工程師 | 5-7 | • Message 規範率 60-90% • 變更粒度合理 • 2-3 種技術棧 • 修復率 15-30% • 功能開發為主 • 有 Code Review 參與但深度一般 |
| 🌱 初級工程師 | 1-4 | • Message 不規範 • 大量修復性提交 • 單一技術棧 • 變更集中於小範圍 • Code Review 參與少或僅 LGTM |
⚠️ 重要：分析報告必須輸出到指定位置！
輸出規則：
.\scripts\output\users\{username}analysis-result.md.\scripts\output\users\john.doe\analysis-result.md報告結構（依據 code-quality-analysis-spec.md）：
# GitLab 開發者評估報告
## 📊 基本資訊
- **開發者**: <username>
- **分析期間**: <start_date> ~ <end_date>
- **分析專案**: <project_count> 個專案
- **報告生成時間**: <timestamp>
- **資料來源**: GitLab API (透過 gl-cli.py v2.0.0+)
---
## 🎯 綜合評分（滿分 10 分）
### 總分：⭐⭐⭐⭐☆ (X.X/10)
**等級**：🏆 高級工程師 / ⭐ 中級工程師 / 🌱 初級工程師
### 詳細評分表
| 評估維度 | 權重 | 得分 | 評級 | 說明 |
|---------|------|------|------|------|
| **程式碼貢獻量** | 12% | X.X/10 | ⭐⭐⭐⭐☆ | XXX 次提交，活躍度高 |
| **Commit 品質** | 23% | X.X/10 | ⭐⭐⭐⭐⭐ | Message 規範率 XX%，變更粒度合理 |
| **技術廣度與深度** | 18% | X.X/10 | ⭐⭐⭐⭐☆ | 涉及 X 種技術棧，全棧能力 |
| **協作能力** | 12% | X.X/10 | ⭐⭐⭐☆☆ | 參與協作，Revert 率低 |
| **Code Review 品質** | 10% | X.X/10 | ⭐⭐⭐⭐☆ | Review 參與度高，深度中等 |
| **工作模式與效率** | 10% | X.X/10 | ⭐⭐⭐⭐⭐ | 工作時段穩定，效率良好 |
| **進步趨勢** | 15% | X.X/10 | ⭐⭐⭐⭐☆ | 各項指標穩定提升 |
**計算公式**：
總分 = (X.X × 0.12) + (X.X × 0.23) + (X.X × 0.18) + (X.X × 0.12) + (X.X × 0.10) + (X.X × 0.10) + (X.X × 0.15) = X.X
---
## 1️⃣ 程式碼貢獻量分析（權重 12%）
### 關鍵指標
- **總提交次數**：XXX 次
- **活躍天數**：XXX 天（佔比 XX%）
- **程式碼新增**：+XXX 行
- **程式碼刪除**：-XXX 行
- **涉及檔案數**：XXX 個
### 評估結果
- ✅ **活躍度評分**：X.X/10
- 📊 **與團隊平均比較**：高於/等於/低於平均 XX%
- 📈 **趨勢**：穩定/上升/下降
### 詳細分析
[根據 statistics.csv 與 commits.csv 的數據，詳細說明開發者的貢獻量表現]
---
## 2️⃣ Commit 品質分析（權重 23%）⭐ **核心指標**
### A. Message 規範性（30%）
- **規範率**：XX% (符合 Conventional Commits)
- **評分**：X.X/10
- **範例優質 Commit**：
feat(auth): add JWT token validation fix(api): resolve null pointer in user service
### B. 變更粒度（40%）
- **小型變更（≤100行）**：XX% (理想：60%+)
- **中型變更（100-500行）**：XX%
- **大型變更（>500行）**：XX% (警示：>10%)
- **評分**：X.X/10
### C. 修復性提交比例（30%）
- **修復率**：XX% (包含 fix, bug, hotfix, revert)
- **評分**：X.X/10
- **分析**：修復率<15%表示程式碼品質高
### 綜合評分：X.X/10
---
## 3️⃣ 技術廣度與深度分析（權重 18%）
### 技術棧分布
| 技術類型 | 涉及檔案類型 | 佔比 | 熟練度 |
|---------|-------------|------|--------|
| 前端開發 | .js, .ts, .jsx, .tsx | XX% | ⭐⭐⭐⭐⭐ |
| 後端開發 | .cs, .java, .py | XX% | ⭐⭐⭐⭐☆ |
| 樣式設計 | .css, .scss | XX% | ⭐⭐⭐☆☆ |
| DevOps | Dockerfile, .yml | XX% | ⭐⭐☆☆☆ |
### 程式語言分布
1. **TypeScript**：XX%
2. **C#**：XX%
3. **Python**：XX%
4. **其他**：XX%
### 專長領域判定
- ✅ **主要領域**：後端開發（C#/Python）
- ✅ **次要領域**：前端開發（TypeScript/React）
- 🔄 **學習中**：DevOps/容器化
### 評分：X.X/10
- 🏆 技術廣度：涉及 X 種語言（5+ 種為優秀）
- 📚 技術深度：在 X 個領域有深入貢獻
---
## 4️⃣ 協作能力分析（權重 12%）
### Merge Requests 參與度
- **總 MR 數量**：XXX 個
- **已合併**：XXX 個 (XX%)
- **平均合併時間**：X.X 天
### 協作模式
- **Merge Commits**：XXX 次（表示參與分支協作）
- **Conflict 處理**：XXX 次
- **被 Revert 次數**：XXX 次（Revert 率：XX%）
### 評分：X.X/10
- ✅ Revert 率 <2%：優秀
- ⚠️ 需改進：提升 MR 合併速度
---
## 5️⃣ Code Review 品質分析（權重 10%）
### A. Review 參與度（30%）
- **Review 總數**：XXX 次
- **Review Comments**：XXX 條
- **與團隊平均比較**：高於/等於/低於平均 XX%
- **評分**：X.X/10
### B. Review 深度（40%）⭐
- **有建議的 Review 比例**：XX%
- **發現的問題分類**：
- Critical Issues（安全、資料遺失）：XXX 個
- Major Issues（效能、邏輯錯誤）：XXX 個
- Minor Issues（風格、命名）：XXX 個
- **評分**：X.X/10
### C. Review 時效性（20%）
- **平均回應時間**：X.X 小時
- **評分**：X.X/10
- **分析**：<4小時為優秀，>72小時會阻礙流程
### D. 被 Review 的接受度（10%）
- **Request Changes 率**：XX%
- **評分**：X.X/10
### 綜合評分：X.X/10
---
## 6️⃣ 工作模式與效率分析（權重 10%）
### 時間分布
**星期分佈**：
- 週一至週五：XX%
- 週末：XX%
**小時分佈**：
- 工作時段（9-18點）：XX%
- 非工作時段：XX%
### 工作模式評估
- ✅ **穩定性**：工作日集中，時間分佈合理
- ⚠️ **警訊**：深夜提交佔比 XX%（建議改善時間管理）
### 評分：X.X/10
---
## 7️⃣ 進步趨勢分析（權重 15%）
### 時間序列對比
| 指標 | 早期表現 | 近期表現 | 變化趨勢 |
|------|---------|---------|---------|
| Commit 規範率 | XX% | XX% | ↗️ 提升 XX% |
| 平均變更粒度 | XXX 行 | XXX 行 | ↘️ 改善 XX% |
| 技術棧數量 | X 種 | X 種 | ↗️ 增加 X 種 |
| 修復率 | XX% | XX% | ↘️ 降低 XX% |
| Code Review 參與 | XXX 次 | XXX 次 | ↗️ 提升 XX% |
### 進步亮點
1. ✅ **Commit 品質提升**：Message 規範率從 XX% 提升至 XX%
2. ✅ **技術棧擴展**：新增 X 種技術棧（列出）
3. ✅ **Code Review 深度提升**：發現 Critical Issues 數量增加
### 評分：X.X/10
---
## 💡 改善建議
### 🔥 優先改善項目（高優先級）
1. **[具體問題]**
- **現況**：XXX
- **目標**：XXX
- **建議行動**：XXX
2. **[具體問題]**
- **現況**：XXX
- **目標**：XXX
- **建議行動**：XXX
### ⭐ 持續優化項目（中優先級）
1. **提升技術廣度**
- 建議學習：XXX
- 建議專案：XXX
2. **深化 Code Review 參與**
- 目標：每週 Review XXX 個 MR
- 重點：發現架構/效能問題
### 📚 長期發展方向
1. **技術領導力**
- 承擔更多架構設計工作
- 帶領技術分享與知識傳承
2. **跨團隊協作**
- 參與更多跨專案協作
- 提升影響力範圍
---
## 📌 數據來源
本報告資料來源於 GitLab API，透過 `gl-cli.py v2.0.0+` 工具收集：
- **使用者基本資料**：`user_profile.csv`
- **提交記錄**：`commits.csv` (XXX 筆)
- **程式碼變更**：`code_changes.csv` (XXX 筆)
- **Merge Requests**：`merge_requests.csv` (XXX 筆)
- **Code Reviews**：`code_reviews.csv` (XXX 筆)
- **統計摘要**：`statistics.csv`
**分析期間**：<start_date> ~ <end_date>
**評估標準**：[程式碼品質評估規範](../../../.copilot/skills/developer-assessment/references/code-quality-analysis-spec.md)
---
**報告結束** | 產生時間：<timestamp>
儲存報告：
# 將上述 Markdown 報告儲存到指定位置
# 路徑格式：.\scripts\output\users\{username}\analysis-result.md
cat > ./output/users/<username>/analysis-result.md << 'EOF'
[將上述報告內容貼上]
EOF
# 確認檔案已成功建立
ls -lh ./output/users/<username>/analysis-result.md
範例：
# 為開發者 john.doe 產生分析報告
# 輸出路徑：.\scripts\output\users\john.doe\analysis-result.md
cat > ./output/users/john.doe/analysis-result.md << 'EOF'
# GitLab 開發者評估報告
## 📊 基本資訊
- **開發者**: john.doe
- **分析期間**: 2025-10-20 ~ 2026-01-20
- **分析專案**: 5 個專案
- **報告生成時間**: 2026-01-21 14:30:00
...
EOF
# 輸出：./output/users/john.doe/analysis-result.md (XX KB)
| 專案名稱 | Commit 數 | 貢獻度 | 角色 |
|---|---|---|---|
| Project A | X | High | Core Developer |
| Project B | Y | Medium | Contributor |
| Project C | Z | Low | Occasional |
核心專案: Project A (貢獻度 X%)
提升專案參與廣度
深化技術深度
知識分享
本報告資料來源於 GitLab，透過 gl-cli.py 工具收集：
user-statsuser-projects報告結束 ```
儲存報告：
# 將上述 Markdown 報告儲存到指定位置
# 路徑格式：.\scripts\output\users\{username}\analysis-result.md
cat > .\scripts\output\users\<username>\analysis-result.md << 'EOF'
[將上述報告內容貼上]
EOF
# 確認檔案已成功建立
ls -lh .\scripts\output\users\<username>\analysis-result.md
範例：
# 為開發者 john.doe 產生分析報告
# 輸出路徑：.\scripts\output\users\john.doe\analysis-result.md
cat > .\scripts\output\users\john.doe\analysis-result.md << 'EOF'
# GitLab Developer Assessment Report
## 📊 基本資訊
- **開發者**: john.doe
- **分析期間**: 2024-10-01 ~ 2026-01-20
...
EOF
# 輸出：.\scripts\output\users\john.doe\analysis-result.md (25KB)
詢問使用者是否需要：
查看報告與資料
.\scripts\output\users\{username}\analysis-result.md.\scripts\output\users\{username}\*.csv進階分析
持續追蹤
缺少相依套件
# 引導安裝
cd scripts
source .venv/bin/activate # 如果有虛擬環境
pip install pandas openpyxl urllib3 python-gitlab
# 或使用 uv（推薦）
cd scripts && uv sync
GitLab 連線失敗
scripts/config.py 設定（GITLAB_URL, GITLAB_TOKEN）無資料返回
權限不足
資料保護
.\scripts\output\，可透過 --output 自訂效能優化
--group-id 限縮查詢範圍報告品質
statistics.csv 取得統計摘要，快速掌握整體表現.\scripts\output\users\{username}\analysis-result.md使用者體驗
.\scripts\output\users\{username}\analysis-result.md使用者: 幫我分析開發者 john.doe 的表現
Skill: 好的！我將協助您分析 john.doe 的開發表現。請回答以下問題：
1. 分析時間範圍？
a) 最近 1 個月
b) 最近 3 個月
c) 最近 6 個月
d) 自訂（請提供起迄日期）
使用者: b
Skill: 2. 專案範圍？
a) 所有專案
b) 特定專案（請列出專案名稱）
c) 特定群組（請提供群組 ID）
使用者: a
Skill: 3. 評估維度？（可多選）
a) 提交活躍度
b) 程式碼品質
c) 專案參與度
d) 技術棧分析
e) 完整評估（全部）
使用者: e
Skill: 收到！開始執行完整評估...
[步驟 1：檢查使用者資料目錄]
Skill: 🔍 檢查 john.doe 的資料目錄是否存在...
路徑：.\scripts\output\users\john.doe\
[情境 A：資料目錄已存在且有 CSV 檔案]
Skill: ✅ 資料目錄已存在，掃描 CSV 檔案...
📁 找到 7 個 CSV 檔案：commits.csv, code_changes.csv, merge_requests.csv...
⏭️ 直接進行分析流程
[情境 B：資料目錄不存在或 CSV 檔案不完整]
Skill: ❌ 資料不存在或不完整
📥 開始收集 john.doe 的資料...
[執行 gl-cli.py user-details --username john.doe ...]
✅ 資料收集完成！
[步驟 2：掃描確認可用的 CSV 檔案]
Skill: 📖 掃描目錄確認可用的 CSV 檔案...
[執行 ls -lah .\scripts\output\users\john.doe\*.csv]
Skill: 根據掃描結果，john.doe 在過去 3 個月有：
- 📊 commits.csv (144KB) - 提交記錄
- 📝 code_changes.csv (20MB) - 程式碼變更詳情
- 🔀 merge_requests.csv (63KB) - Merge Request
- 👀 code_reviews.csv (186KB) - Code Review 記錄
- 📈 statistics.csv (552B) - 統計摘要
現在進行深入分析...
[讀取並分析 statistics.csv、commits.csv、code_reviews.csv 等檔案]
[根據資料產生評估報告]
完成！評估報告已產生：
📄 報告位置：`.\scripts\output\users\john.doe\analysis-result.md`
[顯示報告內容摘要或完整報告]
是否需要：
- 查看完整報告內容？
- 查看詳細 CSV 資料？
- 與團隊平均值比較？
- 進行特定面向的深入分析？
若需要進階分析，可整合：
Git 本地分析 (若有 clone repository)
git log 分析 commit 歷史git blame 分析程式碼擁有權git diff 分析變更品質程式碼品質工具
視覺化工具
當需要查看所有開發者的評估摘要時，此功能會：
.\scripts\output\users\ 目錄下所有開發者的 analysis-result.md.\scripts\output\users\all-user-analysis-result.md| 欄位名稱 | 說明 | 資料來源 |
|---|---|---|
| username | 開發者帳號 | 從目錄名稱或報告中提取 |
| 程式碼貢獻量 | 程式碼貢獻量評分 (X.XX/10) | analysis-result.md 中的「程式碼貢獻量」維度分數 |
| 技術廣度 | 技術廣度評分 (X.XX/10) | analysis-result.md 中的「技術廣度」維度分數 |
| 協作能力 | 協作能力評分 (X.XX/10) | analysis-result.md 中的「協作能力」維度分數 |
| Code Review 品質 | Code Review 品質評分 (X.XX/10) | analysis-result.md 中的「Code Review 品質」維度分數 |
| 工作模式 | 工作模式評分 (X.XX/10) | analysis-result.md 中的「工作模式」維度分數 |
| 進步趨勢 | 進步趨勢評分 (X.XX/10) | analysis-result.md 中的「進步趨勢」維度分數 |
# 開發者評估彙整報告
**生成時間：** 2026-01-21 12:30:13
**總開發者數：** 5
## 📊 綜合評估表
| username | 程式碼貢獻量 | 技術廣度 | 協作能力 | Code Review 品質 | 工作模式 | 進步趨勢 |
|----------|-------------|---------|---------|-----------------|---------|---------|
| G2023018 | 6.00/10 | 10.00/10 | 9.00/10 | 9.00/10 | 10.00/10 | 7.00/10 |
| alice | 8.50/10 | 7.00/10 | 8.00/10 | 9.50/10 | 9.00/10 | 8.00/10 |
| bob | 7.00/10 | 8.50/10 | 7.50/10 | 8.00/10 | 8.50/10 | 7.50/10 |
## 📋 說明
- **程式碼貢獻量**：提交次數、活躍度、產出量
- **技術廣度**：語言分布、檔案類型、技術棧
- **協作能力**：Merge Commits、衝突處理、Revert 率
- **Code Review 品質**：Review 參與度、深度、時效性
- **工作模式**：時間分布、穩定性
- **進步趨勢**：成長曲線、技能提升
---
**資料來源：** 各開發者的 analysis-result.md
# Step 1: 掃描所有開發者目錄
find .\scripts\output\users\ -name "analysis-result.md" -type f
# Step 2: 讀取每個 analysis-result.md
# - 提取開發者名稱
# - 提取各維度評分
# Step 3: 產生彙整表格
# - 使用 Markdown 表格格式
# - 按照指定欄位順序排列
# Step 4: 儲存報告
# 輸出路徑：.\scripts\output\users\all-user-analysis-result.md
使用者：彙整所有開發者的評估報告
Skill：好的！我將彙整所有開發者的評估報告。
[掃描評估報告]
Skill：🔍 正在掃描 .\scripts\output\users\ 目錄...
找到 5 位開發者的評估報告：
- G2023018
- alice
- bob
- carol
- david
[提取評估資料]
Skill：📊 正在提取各維度評分...
[產生彙整報告]
Skill：✅ 彙整報告已產生！
📄 報告位置：.\scripts\output\users\all-user-analysis-result.md
[顯示彙整表格摘要]
是否需要：
- 查看完整彙整報告？
- 依特定維度排序？
- 產生視覺化圖表？
資料來源
analysis-result.md 檔案分數格式
6.00/10）N/A排序方式
資料準確性
評估侷限
隱私考量
使用此 Skill 時，請確保已設定好 GitLab 環境並擁有適當權限。