SuperAPI AI 工具集

architectural-refactor

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:把架构评估文档中的建议落地为可执行的重构,避免编码智能体在长会话、上下文压缩或多会话工作中失去架构一致性。

主要能力:将计划外置到磁盘,用三个文件作为唯一事实来源——refactor-plan.md(有序分块计划,含进入条件、步骤、退出条件)、refactor-manifest.json(机器可读进度跟踪)、refactor-log.md(追加式人类可读日志)。每个分块需可独立验证、可独立提交、粒度适中。执行时按块顺序推进,每块完成后运行测试、类型检查与 lint 作为验证门,通过后提交并记录 commit SHA。

使用方式:先读取用户提供的评估文档,提取变更点、目标架构与顺序约束;若评估含糊则停下询问。随后构建分块计划、做依赖分析(确保无循环依赖)、初始化 manifest,并让用户确认后再执行。执行循环为:读取计划、检查进入条件、更新 manifest、逐步执行、验证、提交、更新状态、记录日志。会话开始或恢复时先读 manifest、计划与日志,并运行验证确认当前状态。验证命令在首次运行时探测并记录到 manifest,如 npm test、npx tsc --noEmit、npm run lint。

适用场景:已有结构化评估(如 seam-ripper、simplicity audit 等输出)并希望安全、可追溯地完成架构级重构的项目。

限制:该技能不决定重构什么,不做架构判断,不处理计划外改进,也不跳过验证。步骤无法按计划执行、验证失败两次或发现漂移信号时必须停止并交由用户决策,不得自行变通。若项目缺少类型检查等某项验证可记录后跳过,但测试不可跳过。资料未提供具体安装命令、收费与平台信息。