SuperAPI AI 工具集

architecture-audit

办公与效率

查看项目

更新于 10-16 07:26

技能介绍

用途:architecture-audit 是一套系统化架构审查工作流,适用于在陌生或继承的代码库上开展重大功能前、扩展里程碑(如 10 倍用户、新区域、新平台)前、为速度牺牲结构的快速增长阶段后,或对长期系统做定期健康检查。不适用于全新设计,全新设计应改用 architect agent 与 brainstorming skill。

主要能力:以“无文件引用的架构主张只是观点”为原则,要求每条发现都带文件引用与后果。流程分六步:一、按实际构建情况绘制系统图,记录入口点、模块/层、外部依赖、数据流与信任边界,并记录与现有架构文档的每处分歧;二、识别承重决策,如单体与服务的取舍、同步与异步、数据所有权、耦合方向、状态管理,并判断是有意还是偶然;三、用 dispatching-parallel-agents skill 并行派发专家审查,包括 architect、security-reviewer、performance-profiler、database-reviewer、infra-reviewer,各自回答限定问题,领域不存在时可跳过;四、整合发现,每条须含证据(文件路径与行号)、后果、修复工作量 S/M/L、不修复的风险;五、按 CRITICAL、HIGH、MEDIUM、LOW 分级并给出对应行动;六、输出结论与报告,判定 SOUND、SOUND-WITH-RISKS 或 INTERVENTION-REQUIRED,并列出前三项行动。CRITICAL 与 HIGH 发现可交给 writing-plans skill 形成修复计划,已接受的风险通过 architect agent 记录为 ADR。

使用方式与限制:资料未提供具体安装命令或代码调用方式,仅给出工作流步骤与模板。该技能强调审查代码而非图表,并列出常见合理化红旗,如“架构没问题,团队小心点就行”“下个功能发布后再审查”“wiki 图显示分层很干净”。资料未提供收费、价格、平台或效果信息。