用途:在编码过程中让架构思考真正有用,不是总结架构理论,而是把架构关注点转化为更好的实现选择、具体的验证步骤和清晰的决策记录。适用于架构意义重大但无单一特定视角的变更。
核心流程:先检查实时代码、仓库指引、当前行为及用户提供的 issue 或设计上下文;将变更范围归类为本地代码、模块、组件、服务、数据边界、部署单元或企业集成;确定该任务最重要的质量属性(默认三个以内);梳理相关边界(组件、依赖、公开契约、数据所有权、运行时通信、部署约束);选择最小可用的架构分析强度:轻量级用于单文件、单函数或窄重构,标准级用于跨模块变更、共享抽象、公开 API、数据访问或重要测试,深度级用于服务边界、存储所有权、架构风格选择、迁移计划、运维行为或需记录的决策;按仓库风格实施、限定修改范围;把每个重要关注点转为验证步骤,优先可执行检查;最后给出变更文件、已运行的检查、决策摘要与剩余风险。
架构显著性过滤器:当选择影响系统结构或组件边界、质量属性(可维护性、可扩展性、性能、可用性、安全、韧性、可部署性、可观测性、可测试性、易用性、可移植性)、模块/服务/团队/供应商间依赖、公开接口或契约/协议/schema/迁移/版本管理、数据所有权与读写路径/事务/一致性/集成流、难以逆转的构建技术或框架/平台/工具/构建系统/流程选择之一时,视为架构显著;否则保持普通代码评审深度。
需运行但不重复实现的视角:本技能为会话级框架,不重新推导各视角分析,而是委派——权衡与耦合、分层放置与内聚、运行时/数据流、适应度函数,并将发现带入风险检查与决策记录。
决策记录触发:当决策改变长期方向、影响多个团队、改变风险态势、引入平台或供应商、改变数据所有权、改变公开契约或解决重复争论时,创建或起草 ADR,模板见 references/adr_risk.md。
风险检查:对标准与深度分析,按影响与可能性标出低/中/高风险;对每个高风险项给出缓解措施、验证步骤,若用户提供团队上下文则指定负责人,纯代码任务则以当前变更集为负责人;完整字段见 references/adr_risk.md。
验证菜单:只选择与最重要两三个质量属性匹配的检查,不必覆盖所有属性;具体检查目录见 references/verification_menu.md。
输出契约:实现类工作最终回复保持简洁,含变更内容、为何架构安全或接受何种权衡、已运行的验证、剩余风险;审查类工作先按严重度给出发现,并附文件与行号引用。
按需阅读的参考文件:references/architecture_lens.md(质量属性、模块化、组件思维、适应度函数)、references/style_fit.md(架构风格选择)、references/adr_risk.md(ADR、风险分析与图表)、references/team_checklists.md(团队边界、评审清单、发布检查)、references/verification_menu.md(按属性的具体验证检查目录)。
限制:资料未提供收费、价格、平台支持等具体信息,暂未提供。该技能依赖同仓库其他参考文件与 architecture-lens 等视角技能配合使用。