Menu
[UDS] Track development metrics, code quality indicators, and project health
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill metricsThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | metrics |
| scope | universal |
| description | [UDS] Track development metrics, code quality indicators, and project health |
| allowed-tools | Read, Grep, Glob, Bash(npm:*, git:log) |
| argument-hint | [metric type or module | 指標類型或模組] |
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
[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.