用途:该技能用于辅助编写 arc42 架构文档第 5 节“构建块视图”(Building Block View)。该节记录系统在源码结构层面的静态分解,以层次化的白盒/黑盒视图呈现各构建块及其关系。
主要能力:技能先收集上下文信息,再生成文档。它会检查第 3 节(上下文与外部接口)、第 4 节(解决方案策略)、第 6 节(运行时场景)和第 7 节(部署)是否存在,并要求第 5 节中的外部接口沿用第 3 节的 IF-xx 编号,组件名称与第 4 节、第 6 节和第 7 节保持一致。随后询问顶层组件及其单一职责、外部接口、组件依赖与数据流、通信方式(REST、gRPC、事件、共享数据库、进程内调用等)、源码目录或模块路径,以及哪些组件复杂到需要 Level-2 内部拆解。
使用方式:技能会依次提问,在拿到回答后再开始生成文档。它强制要求生成 Level-1(整体系统白盒视图,包含组件表和分解理由),并提示不要细化到单个文件、类或方法,构建块应停留在模块、服务、库或子系统层面。用户可以选择详细程度:LEAN 只生成 Level-1 图和组件表;ESSENTIAL 额外为每个 Level-1 组件提供黑盒描述;THOROUGH 再为复杂组件增加 Level-2 内部结构,并标注每个组件满足的需求。
图表与文档:所有图表以独立的 .puml 文件放在 docs/diagrams/ 下,Level-1 图写入 docs/diagrams/building-blocks-level1.puml,Level-2 图写入 docs/diagrams/building-blocks-level2-[component-name].puml,并在 Markdown 中以图片引用方式引用,不在章节正文内嵌 PlantUML 源码。文档结构包含概览、5.1 Level 1 结构图、组件表、分解理由,以及按组件展开的黑盒说明(用途、接口表、源码位置、在 THOROUGH 模式下还包括满足的需求和已知限制)。
审查与迭代:生成草稿后,技能按清单逐项检查,包括 Level-1 是否齐全、外部接口编号是否与第 3 节一致、是否存在循环依赖、黑盒描述是否覆盖所有组件、源码位置是否标注、粒度是否过细、Level-2 是否只用于确实复杂的组件,以及组件名称是否与第 4、6、7 节一致。发现不符合时,会指出问题并给出处理建议,然后询问用户希望进一步细化或扩展的内容并继续迭代。
适用场景与限制:适用于按 arc42 模板编写架构文档、需要保持跨章节一致性和结构化分解的团队。该资料未提供关于收费、价格、平台支持范围或效果保证的信息,暂未提供。