quality-debt-analysis

Use this skill when you need evidence-bounded quality-debt items, origins, impact, age, priority, ownership, and paydown tradeoffs; triggers include 质量债务 and quality debt.

SKILL.md

GitHub

质量债务分析(中文版)

何时使用

  • 需要围绕质量债务项、来源、影响、年龄、优先级、所有人与偿还权衡开展有证据的分析、设计或验证准备。
  • 需要评审现有方案、结果或指标,并形成可执行的改进项。
  • 输入不完整,但仍需交付带假设、信息缺口和人工决策边界的受限初版。

输出格式选项

  • 默认输出 Markdown,按领域风险、证据状态、优先级和边界组织。
  • 用户要求表格、CSV、JSON 或工单格式时,保留相同的发现字段、证据和决策边界。
  • 输出进入自动化流程前,先确认 schema、枚举值、必填项和证据来源。

如何使用

  1. 先阅读并遵循 prompts/quality-debt-analysis.md,包括输入审计、领域覆盖和输出顺序。
  2. 提取范围、环境、版本、时间窗口、约束、成功标准和可用证据,重点检查债务项、产生来源、业务影响、年龄、偿还权衡。
  3. 先区分已确认事实、证据支持的推断、候选建议和 Human 决策,再按风险与证据强度排序。
  4. 把高风险项转成前置条件、步骤、预期结果或判断标准、所需证据和验证方法。
  5. 信息不足时交付受限初版,明确哪些结论不能成立,不把静态材料写成执行结果。

参考文件

  • 校准领域结果、正确对照或证据缺口时,读取 references/domain-decision-example.md 的脱敏输入、逐项预期与复算依据。

  • 每次执行必须读取 prompts/quality-debt-analysis.md;它是本 Skill 的完整执行规范。

  • 需要评测时读取 evals/eval.yaml 和 evals/cases/ 下的匹配用例。

  • 只有目录实际存在且任务需要时,才读取 references/、examples/、scripts/ 或 output-formats.md,不要假设不存在的资产。

领域执行要点

  1. 将已存在产品缺陷、测试/架构债务、暂时例外与数据缺口分列;每条记录来源、当前影响、形成原因、年龄和已有控制,不把所有未完成项叫债务。
  2. 估计风险利息时说明变化路径:后续修改成本、故障暴露、检测延迟等可观察证据;没有费率/频率只给定性或条件范围,不自造金额。
  3. 排序按业务影响、暴露、探测性、依赖和偿还成本/收益,年龄仅为一个信号;新生重大风险可优先于高龄轻微项。
  4. 偿还完成需修复资产、独立行为检查、旧债务效果消失及责任人验收证据;完成ticket或文档不能单独关闭债务,风险接受有期限/授权。

核心约束

  • 只分析质量债务项、来源、影响、年龄、优先级、所有人与偿还权衡,不替代业务负责人或 Human 的风险接受、例外批准和发布决定。
  • 不编造系统行为、字段、指标、阈值、数据、根因、执行记录或通过结论。
  • 静态设计、计划、文件存在或 dry-run 只能保留原证据状态,不能升级为真实执行证明。
  • 证据不足时使用待确认、blocked、unassessed 或 NOT_SCORED,并给出最小验证方法。
  • 涉及生产、隐私或安全时采用最小权限、脱敏数据、mock、dry-run 或隔离环境。

交付前自检

  • 已覆盖债务项、产生来源、业务影响、年龄、偿还权衡,并为每项记录来源、证据状态和验证方法。
  • 已分开事实、推断、候选建议、信息缺口和 Human 决策。
  • 高风险项有 P0/P1/P2/P3 或等价优先级、责任角色和关闭条件。
  • 未把计划、静态检查或 dry-run 写成测试执行、全部通过或发布批准。
  • 已说明剩余风险、停止/升级条件和下一步。

常见误区

  • 只列检查点,不说明触发条件、预期关注点、责任角色、关闭条件和证据。
  • 把相邻领域的指标或工具名当成质量债务的完整判断。
  • 用未经说明的数字制造伪精确,或把相关性写成因果关系。
  • 输入不完整时直接拒绝,或反过来假装结论已经确定。

最佳实践

  • 从最可能造成业务损失、质量回退或决策阻塞的路径开始。
  • 使用最小可验证实验缩小不确定性,并记录条件、版本、来源和证据。
  • 让另一位工程师能够独立安装、执行和复核本 Skill 的产出。