用途
architecting-solutions 是一个用于设计技术方案与软件架构的技能。它帮助 Claude 分析需求，并生成面向软件实现的技术方案文档。适用场景包括：创建非 PRD 的方案简报或技术设计文档、设计软件方案、分析需求、明确功能规格、记录技术计划、规划重构或迁移。当用户提出”设计方案””架构设计””技术设计”等需求且未提及 PRD 时使用。若用户要求的是 PRD，应改用 prd-planner。
主要能力
该技能引导 Claude 按结构化流程工作：明确需求、分析上下文、设计带取舍分析的方案、生成方案文档。它强调在确定方案前先提出多个选项，例如最小改动方案、中等投入方案和全面方案，并对每个主要决策记录选项、优点、缺点和选择结果。
使用方式
安装命令为：通过 apb skills add ./skills/architecting-solutions --scope global --target all --link 安装。工作流以清单方式跟踪进度，共 7 步：明确用户意图与成功标准；识别约束（技术栈、时间线、资源）；分析现有代码库模式；研究最佳实践（如需要）；设计方案架构；生成方案文档；与用户确认。方案文档输出位置为 {PROJECT_ROOT}/docs/{feature-name}-solution.md，文件名使用 kebab-case，例如 data-refresh-logic-refactoring-solution.md。文档必须写入项目 docs/ 目录，而非计划文件或隐藏位置。
核心原则与限制
技能强调”简单优先”，选择满足需求的最简方案，从 MVP 起步迭代扩展；分离关注点，UI、逻辑与数据应分离；注重可复用性与可测试性。它要求在写方案前询问用户偏好哪种选项、是否接受较大重构、对变更的容忍度，并在定稿前获得用户明确批准。技能给出反模式对照，例如”优化代码”应改为”通过记忆化昂贵计算将渲染时间从 100ms 降至 16ms”这类具体表述。它还包含根因分析清单、迁移范围完整性检查、状态与数据流验证、框架不变量、依赖组合完整性、向后兼容性等核对项，并警告避免过度工程，指出全面方案应是”选择”而非”默认”。关于收费、价格、平台等信息，资料中暂未提供。