| source | ../../../../skills/metrics-dashboard-assistant/SKILL.md |
| source_version | 1.1.0 |
| translation_version | 1.1.0 |
| last_synced | "2026-03-26T00:00:00.000Z" |
| status | current |
| description | [UDS] 追蹤開發指標、程式碼品質指示器與專案健康狀態 |
| name | metrics |
| allowed-tools | Read, Grep, Glob, Bash(npm:*, git:log) |
| scope | universal |
| argument-hint | [metric type or module | 指標類型或模組] |
開發指標助手
語言: English | 繁體中文
追蹤開發指標、程式碼品質指示器，以及專案隨時間的健康狀態。
使用方式
| 命令 | 用途 |
|---|
/metrics | 執行完整專案健康檢查 |
/metrics --quality | 僅程式碼品質指標 |
/metrics --debt | 分類技術債報告 |
/metrics --debt-trend | 技術債趨勢 |
/metrics --test | 測試健康指標 |
/metrics src/ | 限定特定模組範圍 |
指標類別
| 類別 | 指標說明 |
|---|
| 程式碼品質 | 複雜度、重複率、lint 警告 |
| 測試健康 | 覆蓋率 %、通過率、不穩定測試數 |
| 提交品質 | 大小、頻率、格式合規 |
| 債務追蹤 | TODO/FIXME 數量、問題存在時間、債務分類 |
| 依賴健康 | 過時套件、漏洞數量 |
技術債分類
基於 SQALE 方法和 ISO/IEC 25010 維護性子特性。
| 類別 | 衡量項目 | 偵測方法 |
|---|
| 程式碼債 | TODO/FIXME、死碼、重複 | Grep, lint |
| 測試債 | 未覆蓋模組、低覆蓋區域 | 覆蓋率報告 |
| 設計債 | 複雜度熱點（cyclomatic > 15）、深層巢狀 | 靜態分析 |
| 文件債 | 未文件化 API、過時文件 | JSDoc/TypeDoc 掃描 |
| 依賴債 | 過時套件、已知 CVE | npm audit/outdated |
債務報告格式
## 技術債報告
**日期**: YYYY-MM-DD | **債務密度**: N 項 / 每千行
### 摘要
| 類別 | 數量 | 嚴重度 | 預估修復時間 | 趨勢 |
|------|------|--------|-------------|------|
| 程式碼債 | 42 | 中 | 21h | ↑ +5 |
| 測試債 | 15 模組 | 高 | 30h | → 穩定 |
| 設計債 | 3 熱點 | 高 | 16h | ↓ -1 |
| 文件債 | 8 API | 低 | 8h | ↑ +2 |
| 依賴債 | 5 過時 | 嚴重 | 4h | → 穩定 |
: 79 小時
[嚴重] CVE-2024-XXXX in lodash — 修復: npm update
[高] src/parser/ 複雜度 28 — 修復: 提取方法
[高] src/payments/ 0% 覆蓋率 — 修復: 新增整合測試
