用途:在项目范围内评估日常评审难以覆盖的结构性技术债,包括长期复杂度、废弃 API 使用、重复代码、架构纠缠以及低价值测试,输出分析报告供有意重构时参考。仅做分析,不修改源码、不暂存文件、不提交。\n\n主要能力:按范围与顶层目录分区扫描,识别复杂度热点、废弃 API、复制簇、跨分区耦合与低价值测试;额外进行项目级架构检查,关注模块边界混乱、循环依赖、分层违规与跨模块重构候选;用 /evaluate-findings 技能去重并核实误报;对需人工决策的升级发现使用 AskUserQuestion 确认;按影响(维护拖累、变更风险、影响范围)与工作量排序为快速收益、战略重构、渐进、推迟四档。\n\n使用方式:可用 $ARGUMENTS 指定路径直接评估,否则用 AskUserQuestion 确认评估全部代码库还是特定路径。执行时先创建各阶段任务,排除生成与第三方目录(如 node_modules/、dist/、build/、vendor/ 等),按顶层目录分区,同一消息内发出全部分区智能体调用与一个项目级架构智能体调用,等待全部回报。分析智能体需先读取 references/debt-reviewer.md,共享工作树与 git 索引视为只读,实证检查在 $TMPDIR 下的独立 git worktree 中进行;每个测试运行器需在独立进程组内带超时运行,结束后核对 git worktree list、git status --short、HEAD 与依赖目录状态。随后运行 /evaluate-findings,处理升级发现,排名并写出 .turbo/technical-debt.md,再依据 /frontend-design 生成自包含的 .turbo/technical-debt.html。\n\n限制:仅覆盖代码内结构性债务;依赖新鲜度与差异范围内缺陷需运行 /review-dependencies 与 /review-code。无显著债务时需明确说明并标注范围限制与分析注意事项。若某测试层会重置共享外部资源(数据库、固定端口、缓存),因其无跨进程互锁,需列为禁止并发运行。无法在独立 worktree 安装依赖时,该检查留空并如实报告。无法修复的破坏需给出确切修复命令代替发现项。未提供的部分:具体收费、价格与平台支持暂未提供。
assess-technical-debt
通用与其它
更新于 10-16 06:15