用途:该技能用于从代码仓库及配套产品文档、架构图中提取系统架构路径信息,帮助梳理核心链路、组件拓扑、依赖风险和观测埋点缺口。
输入:代码仓库地址或本地路径为必填;产品架构图路径和产品文档路径为选填,均支持多次传入。
输出:固定输出到 output/<repo_slug>/ 目录,包含 topology-model.json、core-links.md、dependency-risk.md、observability-gaps.md、evidence-index.json。
建模维度:service graph、request path、async path、dependency graph(DB / Cache / MQ / Third-party)、failure point、observability hook point。
执行规则:每条链路与风险项必须包含文件路径形式的证据来源;核心用户链路、控制面链路、数据面链路必须分别输出;风险与埋点缺口必须能映射到服务或依赖节点;解析失败时输出可诊断信息,不得静默忽略关键输入。
使用方式:通过 CLI 调用,示例命令为 byted-sol-stability-architecture-path-extractor --repo tests/integration/fixtures/sample_repo --product-doc examples/product-doc.md --arch-diagram examples/arch-diagram.md --out-dir output。
适用场景:适用于需要理解既有系统架构、梳理核心链路、评估依赖风险或检查观测埋点覆盖情况的场景。
限制:具体支持的代码语言与依赖类型、解析失败的具体诊断形式、性能与规模上限等资料暂未提供。