用途:当用户要求对代码库做完整架构快照、对子系统绘制图表,或点名某种模式(如数据流、ERD、集成点、失败模式)时,本技能产出以图表为先的架构报告;不适合纯文字解释、从零设计新系统或单文件讲解。
主要能力:八种分析模式各有独立前缀与主图类型——信息架构(I-)、数据流(D-)、集成(X-)、UI 表面(U-)、交互模式(P-)、数据模型(M-)、控制流(C-)、失败模式(F-),前缀编号跨模式稳定。图表中每个节点与边都须有 path:line 引用,无法归属单一文件的“合成概念”需以虚线样式区分并单独列出(每模式上限 20%,交互模式为 35%)。
使用方式:技能内未见可直接调用的命令,资料给出的是其执行流程:先确定范围与模式,创建 docs/architecture/<YYYY-MM-DD>/;再用 find 查找仓库内权威文档并建立主题→文档索引 doc-map.md;随后按模式并行派出子代理,以 confirms/drift/gap/extends 四类对照文档基准分类;编排者做机械校验(解析符号、逐行核对证据、检索缺失断言);再渲染图表并撰写各模式报告(文档引导、缺口优先);最后综合成 README,并用 bash scripts/render.sh <report-dir>/ --style corporate 与 bash scripts/compile-html.sh <report-dir>/ 自动编译 HTML(PDF 仅在用户明确要求时用 compile-pdf.sh)。样式有 corporate(默认)与 blueprint,主题默认 light,支持运行时切换。
适用场景:已有仓库内文档的代码库架构梳理与文档漂移、未记录行为盘点。限制:资料未提供安装命令、依赖之外的具体运行条件与收费标准;H型技能需依赖仓库内文档与引用校验流程。