Tracks development metrics including code quality, test health, commit quality, technical debt, and dependency health over time. Reports use SQALE-based debt classification and trend tracking.
How this skill is triggered — by the user, by Claude, or both
Slash command
/universal-dev-standards:metrics-dashboard-assistant [metric type or module | 指標類型或模組][metric type or module | 指標類型或模組]This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Track development metrics, code quality indicators, and project health over time.
Track development metrics, code quality indicators, and project health over time.
追蹤開發指標、程式碼品質指示器,以及專案隨時間的健康狀態。
| Command | Purpose | 用途 |
|---|---|---|
/metrics | Run full project health check | 執行完整專案健康檢查 |
/metrics --quality | Code quality metrics only | 僅程式碼品質指標 |
/metrics --debt | Classified technical debt report | 分類技術債報告 |
/metrics --debt-trend | Debt trend over time | 技術債趨勢 |
/metrics --test | Test health metrics | 測試健康指標 |
/metrics src/ | Scope to specific module | 限定特定模組範圍 |
| Category | Metrics | 指標說明 |
|---|---|---|
| Code Quality | Complexity, duplication, lint warnings | 複雜度、重複率、lint 警告 |
| Test Health | Coverage %, pass rate, flaky count | 覆蓋率 %、通過率、不穩定測試數 |
| Commit Quality | Size, frequency, conventional format | 大小、頻率、格式合規 |
| Debt Tracking | TODO/FIXME counts, age of issues, debt classification | TODO/FIXME 數量、問題存在時間、債務分類 |
| Dependency Health | Outdated packages, vulnerability count | 過時套件、漏洞數量 |
Based on SQALE methodology and ISO/IEC 25010 maintainability characteristics.
基於 SQALE 方法和 ISO/IEC 25010 維護性子特性。
| Category | What to Measure | 衡量項目 | Detection Method |
|---|---|---|---|
| Code Debt | TODO/FIXME, dead code, duplications | TODO/FIXME、死碼、重複 | Grep, lint |
| Test Debt | Uncovered modules, low coverage areas | 未覆蓋模組、低覆蓋區域 | Coverage report |
| Design Debt | Complexity hotspots (cyclomatic > 15), deep nesting | 複雜度熱點、深層巢狀 | Static analysis |
| Doc Debt | Undocumented APIs, outdated docs | 未文件化 API、過時文件 | JSDoc/TypeDoc scan |
| Dependency Debt | Outdated packages, known CVEs | 過時套件、已知 CVE | npm audit/outdated |
## Technical Debt Report
**Date**: YYYY-MM-DD | **Debt Density**: N items per 1K lines
### Summary
| Category | Count | Severity | Est. Fix Time | Trend |
|----------|-------|----------|---------------|-------|
| Code Debt | 42 | Medium | 21h | ↑ +5 |
| Test Debt | 15 modules | High | 30h | → stable |
| Design Debt | 3 hotspots | High | 16h | ↓ -1 |
| Doc Debt | 8 APIs | Low | 8h | ↑ +2 |
| Dependency Debt | 5 outdated | Critical | 4h | → stable |
**Total Estimated Remediation**: 79 hours
### Top Priority Items
1. [CRITICAL] CVE-2024-XXXX in lodash — fix: npm update
2. [HIGH] src/parser/ complexity 28 — fix: extract methods
3. [HIGH] src/payments/ 0% coverage — fix: add IT tests
Use --debt-trend to compare against previous snapshots.
使用 --debt-trend 與過去的快照比較。
User: /metrics --debt-trend
AI: Technical Debt Trend (last 3 months):
Code Debt: ████████░░ 42 (+5) ↑ increasing
Test Debt: ██████░░░░ 15 (0) → stable
Design Debt: ███░░░░░░░ 3 (-1) ↓ improving
Doc Debt: ████░░░░░░ 8 (+2) ↑ increasing
Dep Debt: ██░░░░░░░░ 5 (0) → stable
Overall: 73 items (was 67) — ⚠️ debt increasing
The health score is a weighted composite:
健康分數為加權組合:
| Factor | Weight | Ideal | 理想值 |
|---|---|---|---|
| Test coverage | 30% | >= 80% | >= 80% |
| Lint pass rate | 20% | 100% | 100% |
| TODO/FIXME density | 15% | < 1 per 1K lines | < 每千行 1 個 |
| Build success | 20% | 100% | 100% |
| Dependency freshness | 15% | < 3 months | < 3 個月 |
Score = sum(factor_score * weight)
User: /metrics
AI: Analyzing project health...
Code Quality: B+ (complexity avg 8.2, 0 lint errors)
Test Health: A (coverage 87%, 0 flaky tests)
Debt Tracking: C (42 TODOs, 3 FIXMEs)
Overall Score: 78/100 (Good)
User: /metrics --debt
AI: Technical Debt Summary:
TODO: 42 (12 in src/legacy/, 8 in src/utils/)
FIXME: 3 (all in src/parser/)
Oldest: 6 months (src/legacy/auth.js:45)
Trend: +5 since last month (increasing)
After /metrics completes, the AI assistant should suggest:
指標分析完成。建議下一步 / Metrics analysis complete. Suggested next steps:
- 執行
/refactor處理高複雜度模組 ⭐ Recommended / 推薦 — Address high-complexity modules- 執行
/coverage改善低覆蓋率區域 — Improve low-coverage areas- 執行
/audit檢視安全與依賴問題 — Review security & dependency issues- 執行
/metrics --debt-trend追蹤技術債趨勢 — Track debt trend over time- 執行
/retrospective在回顧中討論技術債 — Discuss tech debt in retrospective
| Version | Date | Changes | 變更 |
|---|---|---|---|
| 1.1.0 | 2026-03-26 | Add tech debt classification, SQALE quantification, trend tracking | 新增技術債分類、SQALE 量化、趨勢追蹤 |
| 1.0.0 | 2026-03-24 | Initial release | 初始版本 |
完整的 AI 行為定義請參閱對應的命令文件:
/metricsFor complete AI agent behavior definition, see the corresponding command file:
/metrics
CC BY 4.0
npx claudepluginhub asiaostrich/universal-dev-standards --plugin universal-dev-standardsAnalyzes codebases to identify and prioritize technical debt across code, architecture, testing, documentation, and infrastructure.
Identifies, categorizes, and prioritizes technical debt across code, architecture, tests, dependencies, docs, and infrastructure. Scores by impact, risk, effort; outputs remediation plans.
Analyzes codebase complexity, dependencies, dead code, tech debt, and git hotspots. Produces a health score and rescue plan for legacy projects or external repo evaluation.