metrics

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% 覆蓋率 — 修復: 新增整合測試