SuperAPI AI 工具集

technical-debt-register

办公与效率

查看项目

更新于 10-16 06:49

技能介绍

用途:为团队或服务产出一份完整的技术债登记册,把债务变成可见、有归属、可排序、含预期回报的清单,帮助工程团队决定先还哪些债、按什么顺序还。它不是抱怨清单,管理的目标也不是清零,而是在利息成本超过修复成本时解决债务。

主要能力:提供债务分类定义(代码质量、架构、测试、安全、依赖、基础设施、可观测性、流程)及示例;给出评分方法:业务影响1-5分、解决工作量1-5分(分数越低越容易),优先级分数=业务影响×(6−工作量);生成债务登记表(含ID、条目、分类、影响、工作量、优先级、状态、负责人);按分类和优先级做分布统计;为优先级最高的5项写解决计划(问题、业务影响、解决思路、可工单化步骤、验收标准、工作量估算、建议迭代);制定季度债务削减路线图和迭代容量分配模型(建议每迭代15%-20%用于还债);记录已接受/暂缓债务及其理由、复核日期与负责人。

必要输入:团队或服务名称;已知债务条目(也可由Claude通过追问遗留代码、缺失测试、过时依赖、架构捷径、手工流程、可观测性缺口、安全积压来挖掘);技术栈;团队规模与速率(工程师人数、每迭代大致故事点或天数);当前季度/规划周期。

使用方式:由技能按上述格式生成登记册;也可在用户希望自行填写时提供可填模板。技能附带支持文件:references/debt-pricing.md(债务定价,把“很糟”变成可排序的数字)与templates/debt-entry.md(含质量门禁的填写版)。

限制与注意:不得凭感觉随意打分,必须按公式计算;不要把技术债(有意的捷径)与缺陷(非预期问题)混为一谈;不要因安全与依赖项“偏技术”而低估其业务影响;不得存在永久暂缓项,每个接受/暂缓项都要有负责人和复核日期;条目必须在满足验收标准后才算关闭。输出可用0-40分评分标准自检,32分以上为可交付质量。具体价格、平台支持等信息暂未提供。