用途:该技能面向系统架构层面的记录与理解,适用于撰写架构文档、梳理系统结构、绘制图表、分析组件关系,强调接口与数据流的契约,而非逐行实现。
主要能力:识别主要组件与单一职责;分析公开 API、跨边界数据结构与组件契约;描述数据进入、转换与状态存储;梳理外部系统连接、协议格式及失败模式;评估可靠性、扩展性与安全等质量属性。输出倾向使用组件图、序列图等示意,并采用组件职责表、数据流、关键决策表、API 契约等格式。
核心约束:只关注接口与数据输入输出,以及主要流程、契约、行为和失败模式;若开始描述实现细节即应停止并拉远视角。避免内部函数实现、逐行代码分析、次要工具函数、非架构性算法、变量名、循环与条件、数据库表结构细节(仅可写“在 Y 中存储 X”)。反模式示例:不写“函数遍历条目”“第 42 行调用 validate”“for 循环处理每条记录”“使用 HashMap”,而写“组件 X 将输入转换为输出”“校验发生在 API 边界”“记录由 A 流向 B 再到 C”“状态缓存在内存中”。
分析框架:1) 组件识别——主要组件/模块、各自单一职责、组织方式;2) 接口分析——公开 API、跨边界数据结构、组件契约;3) 数据流——进入、转换、状态存储;4) 集成点——外部系统、协议/格式、失败模式;5) 质量属性——可靠性、扩展性、安全措施。
文档格式:架构概览包含目的、组件职责与依赖表、数据流图、关键决策与权衡表;API 契约可含端点、请求、响应及错误码说明。图表可用 Mermaid 的组件图与序列图。
限制:资料未提供具体安装命令、收费方式、平台信息或运行步骤;该技能本质是文档与设计分析规范,不涉及代码执行。