服务架构可视化助手 Skill 技能

技能简介

astrabit-cpt-arch-view（服务架构可视化） 解决一个典型痛点：分布式服务的元数据散落在几十个仓库里，架构评审时没人说得清服务之间到底怎么依赖。这个 Skill 会聚合各仓库的 catalog-info.yaml 元数据，自动生成服务依赖图、请求流向图、事件拓扑图和服务分组表，全部以 Mermaid 图和 Markdown 表格输出，可直接贴进架构评审文档。技能在 Skillstore 质量评分 82 分（silver 档），riskLevel 为 safe，已完成安全审计，支持 Claude、Codex、Claude Code，采用 MIT 许可。

核心能力

• 元数据采集：从本地仓库目录收集 catalog-info.yaml，提取依赖、路由、事件、负责人等字段。
• 依赖关系图：依据 dependsOn 关系构建服务依赖图，一眼看清上下游。
• 请求流向图：解析网关路由元数据，画出"入口路由 → 下游服务"的调用路径。
• 事件拓扑图：从生产者/消费者 topic 关系生成事件驱动架构的拓扑视图。
• 服务分组：按业务域、负责人、组件类型三个维度分组，暴露归属不清的服务。
• 标准化产出：统一输出 Mermaid 图与 Markdown 表格，配套架构评审用的汇总说明，并标注元数据缺口与假设。

安装配置

1. 在项目目录执行 npx skillstore add astrabit-cpt/arch-view 完成安装。
2. 适用工具为 Claude、Codex、Claude Code 三种，安装后在对应 Agent 中直接调用。
3. 前置条件：目标仓库需包含结构规范的 catalog-info.yaml（含 dependsOn、路由、事件、负责人字段），否则图里会缺关系。
4. 如启用可选的 GitHub 仓库发现能力，需预先配置 GitHub CLI 并完成用户授权；技能涉及外部命令执行，建议在受控仓库环境运行。

使用步骤

1. 生成依赖图：让 Agent "基于 repos/ 下的仓库生成服务依赖图，缺失的元数据一并标出"。
2. 映射请求流：针对网关服务执行请求流映射，列出全部路由与对应下游服务。
3. 按域对比：把所有服务按域、负责人、类型分组，高亮没有负责人或元数据缺失的域。
4. 完整架构评审视图：一次性生成依赖、请求流、事件拓扑、服务分组四个板块，并附元数据缺口与假设说明。
5. 发布前人工复核：把生成的图交给服务负责人确认后再对外发布。

适用场景

• 架构评审准备：评审会前快速产出依赖视图，替代"凭记忆讲架构"。
• 迁移与重构规划：改造前先看清服务间依赖，评估影响面。
• API 设计讨论：用请求路径图说明网关路由与下游服务的对应关系。
• 文档归属盘点：按域和负责人分组，找出哪些域缺 owner、哪些服务缺元数据，补齐文档治理短板。

适用人群

架构师、平台与 DevOps 工程师、技术负责人、正在做服务迁移规划的工程团队，以及需要向管理层展示系统全貌的项目负责人。

工作原理

技能以"元数据即事实源"为原则工作：先扫描本地仓库收集 catalog-info.yaml，再分别解析 dependsOn 依赖关系、网关路由表、事件 topic 的生产消费关系，随后按域/负责人/组件类型归组，最终渲染成 Mermaid 图和 Markdown 表格输出。它只读元数据、不探测运行时流量，因此生成的图反映的是"仓库里记录的架构"，元数据过期时结果也会偏差——Skill 官方也因此建议评审前先更新 catalog-info.yaml，并注明它是只读采集、不做 shell 执行，安全审计确认无提示注入风险。

官方链接

• 技能主页：https://skillstore.io/skills/astrabit-cpt-arch-view
• 源码仓库：https://github.com/AstraBit-CPT/astrabit-docs/tree/master/.claude/skills/arch-view
• 技能清单：https://skillstore.io/api/skills/astrabit-cpt-arch-view/manifest