架构治理(专业版)
将以下提示词粘贴到你的 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,要把分层覆盖率与跨层数据问题整理成可存档交付物
- 维护整洁架构约定的后端工程师,新建模块时想按项目分层约定做服务端自动检查
- 实施交付或审计留档的项目经理,需要不涉及改代码、只出报告的架构合规证明材料