菜单
Quantify and prioritize technical debt as principal plus interest. Use when building a debt register, justifying remediation budget, or sequencing payoff against feature work.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tech-debt-assessment |
| description | Quantify and prioritize technical debt as principal plus interest. Use when building a debt register, justifying remediation budget, or sequencing payoff against feature work. |
Treat tech debt as a financial instrument: each item has a principal (cost to fix), an interest rate (ongoing drag on lead time, change failure rate, or incidents), and a maturity (when it becomes blocking). Quantification turns "we need to refactor" into a defensible portfolio decision aligned with DORA metrics and business outcomes.
| Concern | Recommended |
|---|---|
| Debt taxonomy | Martin Fowler quadrant + McConnell categories |
| Static signal | SonarQube 11, CodeScene, Semgrep, ArchUnit/NetArchTest |
| Runtime signal | OpenTelemetry, DORA metrics via Faros / LinearB |
| Register | Backstage TechInsights, ADRs in repo, JIRA "debt" type |
| Modeling | Monte Carlo on lead-time impact; Cost of Delay (CD3) |
| Reference | Neal Ford, "Building Evolutionary Architectures" 2e (2023) |
flowchart LR
A[Inventory signals] --> B[Classify quadrant]
B --> C[Estimate principal hours]
C --> D[Estimate interest hrs/sprint]
D --> E[Score CD3 = value/duration]
E --> F[Prioritize + schedule]
F --> G[Track via fitness functions]
# debt-register.yaml entry
- id: DEBT-2026-014
title: Order service couples to legacy pricing schema
category: architecture
quadrant: prudent-inadvertent
principal_days: 12
interest_hours_per_sprint: 9
risk: "blocks EU pricing rollout Q3"
cd3_score: 8.4
owner: payments-platform
fitness_function: archunit:NoLegacyPricingImports
| Pitfall | Mitigation |
|---|---|
| Listing debt without quantification | Require principal and interest fields; reject otherwise |
| Treating all debt as bad | Use quadrant; some prudent debt is rational |
| Big-bang rewrite proposals | Prefer strangler fig + fitness functions |
| Debt register rots | Auto-refresh from Sonar/CodeScene weekly via Backstage |
| Ignoring knowledge debt | Track bus factor and onboarding time as first-class items |
debt-register.yaml (or Backstage TechInsights entity) with quantified items.Build production integrations with Anthropic Claude (Claude 4.5 Sonnet, Claude Opus 4, Claude Haiku 4) via the Messages API — system prompts, multi-turn conversations, tool use (function calling), prompt caching, extended thinking, vision, batched requests, and streaming. Use when wiring Claude into backends, agentic workflows, or evaluating it against other foundation models. Requires ANTHROPIC_API_KEY.
Deploy Cloudflare Workers, Pages, and Workers-with-static-assets safely using Wrangler 4.x with versioned uploads, gradual deployments, preview/production environments, secret bindings, observability, and one-command rollback. Use when shipping edge workloads, API routes, or full-stack apps to Cloudflare. Requires CLOUDFLARE_API_TOKEN with scoped permissions or an authenticated Wrangler session.
Deploy static sites, framework apps (Next.js, Astro, Remix, SvelteKit, Nuxt), Edge Functions, and serverless Functions to Netlify with deploy previews, branch deploys, atomic production promotion, scoped env vars, and instant rollback. Use when releasing on Netlify via CLI, API, or Git-triggered builds. Requires NETLIFY_AUTH_TOKEN (PAT) and NETLIFY_SITE_ID.
Transcribe audio with OpenAI speech-to-text models (gpt-4o-transcribe, gpt-4o-mini-transcribe, whisper-1) using prompt-guided terminology, segment-level timestamps, optional diarization via post-processing, and reliable artifact delivery. Use when converting interviews, calls, podcasts, or meeting recordings into reviewable text. Requires OPENAI_API_KEY.
Deploy Web Services, Private Services, Background Workers, Cron Jobs, Static Sites, PostgreSQL, and Key-Value (Redis-compatible) on Render via Blueprints (`render.yaml`) or the Render API with preview environments, zero-downtime rolling deploys, health checks, env-group secret scoping, and one-click rollback. Use when releasing services, applying schema migrations, or syncing infra-as-code on Render. Requires RENDER_API_KEY (owner- or workspace-scoped).
Operate Sentry end-to-end — error monitoring, performance tracing, session replay, profiling, release health, source-map upload, ownership routing, alert tuning, issue triage, and CI integration via sentry-cli — across web, mobile, and backend stacks. Use when instrumenting an app, wiring releases into deploy pipelines, or running incident-grade triage. Requires SENTRY_AUTH_TOKEN (org-scoped, `project:releases project:write`), project DSN, and (for source maps) `org` + `project` slugs.