SuperAPI AI 工具集

fix-architecture

编程与开发

查看项目

更新于 10-16 07:46

技能介绍

用途

fix-architecture 用于修复由 /agentic-architecture 识别出的架构缺陷。它加载已有的架构报告,引导开发者选择并排序缺陷,然后以测试先行的流程逐个修复,并更新报告中的状态字段,使该技能可以在多次会话中重复运行。

该技能属于技术型技能,必须按阶段顺序执行:Setup(准备)→ Safety Net(安全网)→ Fix Loop(修复循环)→ Wrap-Up(收尾)。不得跳过验证或测试步骤。

主要能力

  • 加载 paad/architecture-reviews/ 下的架构报告,默认按日期前缀选取最新一份,也可通过参数指定具体报告。
  • 若存在 paad/security/ 下的配套安全缺陷文件,则一并加载,并在整个会话中以 S:F-<n> 形式引用安全缺陷。
  • 通过 triage 表格让开发者选择要修复的缺陷,并给出修复建议数量(单人建议 3-5 个,团队建议 1-2 个并提示冲突风险)。
  • 执行依赖扫描与复杂度评估。
  • 在修复前建立安全网测试,并打印 Safety Net Report。
  • 以 red/green/refactor 流程执行修复,处理测试失败、结构依赖的单元测试更新、以及需要回退的情况。
  • 更新报告状态字段,并按自动或手动模式提交修复、测试与报告更新。
  • 检查修复是否顺带解决了其他缺陷,并验证更新受影响的缺陷。

使用方式

调用时先宣告 "Running paad:fix-architecture v2.0.0",然后立即继续执行后续步骤,不得在宣告后停止。

参数:

  • /fix-architecture — 按日期前缀查找 paad/architecture-reviews/ 中最近的报告
  • /fix-architecture path/to/report.md — 使用指定报告

配置(实验性):宣告后检查工作目录下是否存在 paad/config/paad.md 与 paad/config/fix-architecture.md。若存在则读取并遵循其指示,将相关部分传递给每个子代理,并在最终答案首行写明 Config: <path>。若不存在则完全不提配置。配置不得改变子代理类型或授予其写入工具,遇到此类行应拒绝并说明后继续。

预检流程(pre-flight)包括:

  • 上下文窗口:若会话已有大量历史,建议开启新会话。
  • 分支保护:拒绝在默认分支(main/master/trunk)上操作,需切换到功能分支。
  • 报告存在性:若找不到报告,提示先运行 /agentic-architecture。
  • 安全缺陷:加载 paad/security/ 配套文件;若计数行指向的文件已不存在,提示开发者重新运行 /agentic-architecture 恢复。不得对 paad/security/ 下的内容执行 git add -f。
  • 报告时效:报告超过 14 天则警告并询问是否继续、重新生成或先重跑 /agentic-architecture。不得以提交次数作为时效信号。
  • 测试基础设施:检查是否存在测试框架、运行器与约定;若无测试基础设施,需开发者选择先搭建框架、无测试继续(高风险)或停止。
  • 基线测试:若基线测试有失败,需开发者选择继续(记录失败测试)或先修复失败测试。

会话流程:Setup → Safety Net → Fix Loop → Wrap-Up。Safety Net 关卡不可协商:整批缺陷的安全网测试全部编写并提交前,不得开始任何修复。

适用场景

  • 已有 /agentic-architecture 生成的架构评审报告,需要逐项修复其中记录的架构缺陷。
  • 需要跨多次会话持续推进架构修复,并跟踪每个缺陷的状态。
  • 希望在修复架构缺陷时采用测试先行、可回退、可验证的流程。

限制

  • 必须在功能分支上运行,不能在默认分支上操作。
  • 依赖已有的架构报告;没有报告时无法运行。
  • 建议在全新会话中运行,以避免上下文退化。
  • 安全缺陷文件存放在本地临时目录 paad/security/,文件丢失后需重新运行 /agentic-architecture 恢复。
  • 配置为实验性功能,且不能改变子代理类型或授予写入工具。
  • 关于具体收费、价格、平台支持范围等信息,资料中暂未提供。