用途:用于系统设计、架构评估、技术选型与规模规划,把设计问题转化为“选项+权衡+成文决策”。不适用于琐碎技术选择、过早优化、需求未文档化的情况。
主要能力:按阶段推进工作流(仅前进不后退):Discovery(收集需求)、Codebase Analysis(分析代码库)、Constraint Evaluation(评估约束)、Solution Design(设计解决方案)、Documentation(记录架构);复杂设计可在 Documentation 前插入 Review & Refinement。小问题可直接跳到 Solution Design,绿地项目可跳过 Codebase Analysis,无需 ADR 时可跳过 Documentation。任务格式如“Discovery {问题域}”“Design {方案}”。
使用方式:以 EnterPlanMode 呈现 2-3 个可行选项及权衡,让用户选择编号、修改或组合;选定后复述决策、列出影响、提出顾虑、补充澄清问题。文档阶段按 ADR 模板记录:状态、日期、决策者、背景、决策、备选方案(利弊与未选原因)、后果、实施说明、成功指标、复查日期。需配合 maintain-tasks 技能做阶段跟踪。
原则与约束:偏好经生产验证而非新奇技术,每层抽象须带来 10 倍价值,模块单一职责、接口清晰,可观测性优先(RED 指标、分布式追踪、结构化日志、基于 SLO 的告警与值班手册),默认用现代成熟模式并尊重遗留系统,设计面向演进(API 版本化、特性开关、可迁移)。技术选择准则:团队经验、性能需求、生态、类型安全、部署目标。绝不推荐未经验证的新技术、过度设计、跳过约束分析或提出团队无法运维的架构。
适用场景:新系统设计、重大特性规划、技术栈决策、容量与性能规划、架构权衡分析。限制:不处理琐碎技术选择、过早优化和无文档需求;具体收费、平台支持等信息暂未提供。