metrics
[UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 Use when: 評估專案的持續健康狀態、分類技術債並觀察其趨勢、向團隊回報程式碼品質。 Not for: 初次評估一個不熟悉的程式碼庫——請用 /discover；單看測試覆蓋率——請用 /coverage 或 /ac-coverage。 Keywords: metrics, code quality, technical debt, project health, debt trend, 開發指標, 技術債, 專案健康度, 品質趨勢.
소스 정보
- 저장소
- AsiaOstrich/universal-dev-standards
- 최근 소스 활동
- 2026년 8월 20일 06:47
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 75
- 포크
- 13
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- metrics
- source
- ../../../../skills/metrics-dashboard-assistant/SKILL.md
- source_version
- 1.1.0
- translation_version
- 1.2.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- description
- [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 Use when: 評估專案的持續健康狀態、分類技術債並觀察其趨勢、向團隊回報程式碼品質。 Not for: 初次評估一個不熟悉的程式碼庫——請用 /discover；單看測試覆蓋率——請用 /coverage 或 /ac-coverage。 Keywords: metrics, code quality, technical debt, project health, debt trend, 開發指標, 技術債, 專案健康度, 品質趨勢.
- allowed-tools
- Read, Grep, Glob, Bash(npm:*, git:log)
- scope
- universal
- argument-hint
- [metric type or module | 指標類型或模組]
# 開發指標助手
> **語言**: [English](../../../../skills/metrics-dashboard-assistant/SKILL.md) | 繁體中文
追蹤開發指標、程式碼品質指示器，以及專案隨時間的健康狀態。
## 使用方式
| 命令 | 用途 |
|------|------|
| `/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 |
### 債務報告格式
```markdown
## 技術債報告
**日期**: YYYY-MM-DD | **債務密度**: N 項 / 每千行
### 摘要
| 類別 | 數量 | 嚴重度 | 預估修復時間 | 趨勢 |
|------|------|--------|-------------|------|
| 程式碼債 | 42 | 中 | 21h | ↑ +5 |
| 測試債 | 15 模組 | 高 | 30h | → 穩定 |
| 設計債 | 3 熱點 | 高 | 16h | ↓ -1 |
| 文件債 | 8 API | 低 | 8h | ↑ +2 |
| 依賴債 | 5 過時 | 嚴重 | 4h | → 穩定 |
**總預估修復時間**: 79 小時
### 最高優先項目
1. [嚴重] CVE-2024-XXXX in lodash — 修復: npm update
2. [高] src/parser/ 複雜度 28 — 修復: 提取方法
3. [高] src/payments/ 0% 覆蓋率 — 修復: 新增整合測試
```
### 趨勢追蹤
使用 `--debt-trend` 與過去的快照比較。
```
User: /metrics --debt-trend
AI: 技術債趨勢（近 3 個月）：
程式碼債: ████████░░ 42 (+5) ↑ 增加中
測試債: ██████░░░░ 15 (0) → 穩定
設計債: ███░░░░░░░ 3 (-1) ↓ 改善中
文件債: ████░░░░░░ 8 (+2) ↑ 增加中
依賴債: ██░░░░░░░░ 5 (0) → 穩定
總計: 73 項（前次 67）— ⚠️ 債務增加中
```
## 快速健康分數
健康分數為加權組合：
| 因素 | 權重 | 理想值 |
|------|------|--------|
| 測試覆蓋率 | 30% | >= 80% |
| Lint 通過率 | 20% | 100% |
| TODO/FIXME 密度 | 15% | < 每千行 1 個 |
| 建構成功率 | 20% | 100% |
| 依賴新鮮度 | 15% | < 3 個月 |
**分數 = sum(因素分數 * 權重)**
## 工作流程
1. **收集** - 從工具與 git 歷史收集原始指標
2. **分析** - 與閾值及歷史趨勢比較
3. **報告** - 產生含可行動重點的摘要
4. **趨勢** - 顯示方向（改善 / 衰退 / 穩定）
## 下一步引導
`/metrics` 完成後，AI 助手應建議：
> **指標分析完成。建議下一步：**
> - 執行 `/refactor` 處理高複雜度模組
> - 執行 `/coverage` 改善低覆蓋率區域
> - 執行 `/audit` 檢視安全與依賴問題
> - 執行 `/metrics --debt-trend` 追蹤技術債趨勢
> - 執行 `/retrospective` 在回顧中討論技術債
GitHub에서 보기