locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md
追踪开发指标、代码品质指示器与专案健康状态。 使用时机:评估专案健康、追踪技术债、监控品质趋势。 关键字:metrics, dashboard, quality, coverage, complexity, debt, 指标, 品质, 技术债。
npx skillsauth add asiaostrich/universal-dev-standards locales/zh-CN/skills/metrics-dashboard-assistantInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
语言: 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 小时
### 最高优先项目
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(因素分数 * 权重)
/metrics 完成后,AI 助手应建议:
指标分析完成。建议下一步:
- 执行
/refactor处理高复杂度模组- 执行
/coverage改善低覆盖率区域- 执行
/audit检视安全与依赖问题- 执行
/metrics --debt-trend追踪技术债趋势- 执行
/retrospective在回顾中讨论技术债
development
[UDS] 扫描代码库的调试残留与代码质量问题;可自动修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
tools
[UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
development
[UDS] 识别重复流程并以正确的开发深度构建 Skill
tools
[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, 推送, 保护分支, 质量门禁.