Agent Skills
返回列表
架构治理(专业版)

架构治理(专业版)

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @metago/metago-arch-pay。

技能介绍

要解决什么问题

微服务或单体后端在迭代几年后,常见问题是目录像分层、依赖却横飞:领域层直接引基础设施、循环依赖藏在 import 里,评审时只能靠肉眼扫树。重构或交付前若缺少一份可存档的违规清单与修复方向,容易在方案讨论里反复争论「算不算违规」。

本技能面向需要完整架构检查报告的场景:架构评审、重构前盘点、交付留档,以及新建模块时的依赖方向与 SOLID / 整洁架构合规核对。

技能如何工作

由 metago.life 架构治理引擎在服务端执行检查,输出格式固定、内容一致。专业版相对免费版(规则与人工清单)会交付结构化报告,典型包括:

  • 层级与依赖方向检查,并列出违规项(位置、规则、修复方案)
  • 分层覆盖率的量化结果
  • 命名与跨层数据问题归纳
  • 整改建议与优先级

触发后,Agent 按 X402 协议完成付费授权(需已安装 weixinpay 插件),支付成功后重试请求即可拿到《架构治理检查报告》正文;不确定项会标注置信度。

边界与注意点

  • 技能只输出报告与建议,不自动改代码,不能替代 CI/CD 里你们自有的门禁策略。
  • 分层合规的核心是依赖方向,不是文件夹名字;跨层引用在合理场景下可走白名单,不宜一律判死。
  • 目录或代码说明不足时,会基于现有信息检查并标注未覆盖范围;可在 query 里写明你的分层约定,服务端按约定检查。

使用场景

  • 重构前需要盘点 my-service 各模块依赖方向,并输出可评审的违规清单与修复方案
  • 交付甲方前要对分层覆盖率、跨层引用做量化检查,并留档完整架构报告
  • 新建业务模块时核对是否违反 SOLID 与整洁架构约定,避免上线后再拆依赖
  • 架构评审会上需要固定格式的层级检查结论,而非仅靠目录树口头讨论

适合人员

  • 负责单体/微服务重构的技术负责人,需要在动工前拿到依赖违规清单与优先级整改建议
  • 对接内外部架构评审的 Tech Lead,要把分层覆盖率与跨层数据问题整理成可存档交付物
  • 维护整洁架构约定的后端工程师,新建模块时想按项目分层约定做服务端自动检查
  • 实施交付或审计留档的项目经理,需要不涉及改代码、只出报告的架构合规证明材料