SuperAPI AI 工具集

reviewing-aspire-architecture

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能通过 reviewing-aspire-architecture 智能体执行 Aspire 专属架构审查,捕捉通用代码审查无法发现的领域模式。

使用条件:仅当用户明确要求对现有 PR 或 diff 做深度架构审查、Aspire 模式审查或同等领域审查;或通用审查已完成并发现一个必须依赖 Aspire 架构知识才能解决的明确问题,此时审查者需说明相关 diff 证据、未决问题、适用的 Aspire 契约及为何常规审查无法判定正确性,并仅就该聚焦问题调用。不得仅为增加信心或获取第二意见而升级。变更文件位置只是技能选定后的路由信息,不构成选择理由。

不适用:实现、调试、测试、常规代码改动、变更后验证、设计问题或头脑风暴、解释性调查、通用 PR 审查、CI 失败、不稳定测试、API 表面审查。这些场景应使用 code-review、ci-test-failures、fix-flaky-test 或 api-review。

调用守卫:父级可为一次用户审查请求和变更集修订加载一次技能并启动一个智能体;若技能上下文已加载或当前智能体即为该智能体,不得再次调用或启动新智能体,后续工作应在现有对话中继续。完成或修改代码不会自动触发再次审查,仅在用户明确要求且 diff 有实质变化时重跑。

与 code-review 的关系:code-review 覆盖通用缺陷、安全、性能、并发与错误处理,普通 PR 审查足够;本技能只覆盖需要 Aspire 领域知识的检查。安全、性能、错误处理等主题两者都有,但检查项互不重叠。用户明确要求深度审查时可直接调用,无需先跑 code-review;普通审查则须先完成 code-review,再在正确性依赖具名 Aspire 领域契约时升级。若 code-review 已能给出具体高置信缺陷,应直接报告而非升级。升级时保留通用发现,只运行一次聚焦架构分析并合并其净新增高置信发现,之后不再重跑 code-review。

审查范围:显式完整架构审查时,检查 PR 上下文及按变更文件路由选定的维度;升级场景只检查所给问题、相关 diff、周边代码和避免重复所需的既有评论,不扩展为完整 PR 审查或全仓库盘点。

文件夹到维度路由:src/Aspire.Hosting/** 对应资源模型、API 设计、模式一致性、容器;src/Aspire.Hosting.Azure*/** 对应 Azure 预配、资源模型、API 设计、安全;src/Aspire.Dashboard/** 对应仪表板 UI/UX、安全、性能;src/Aspire.Cli/** 对应 CLI 行为、错误处理、平台兼容性;src/Components/** 对应模式一致性、API 设计、构建与贡献者工作流;tests/** 对应测试质量及被测代码的镜像维度;eng/、.github/ 对应构建与贡献者工作流、文档与命名。完整审查规则见 reviewing-aspire-architecture 智能体。