Menu
针对具体功能需求，生成聚焦业务逻辑、数据流转、性能与稳定性设计的技术方案。 适用于功能评审和开发指导。默认使用四部分轻量模板；仅在用户明确要求架构设计方案时使用八部分架构模板。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | tech-design |
| displayName | 技术方案设计 |
| description | 针对具体功能需求，生成聚焦业务逻辑、数据流转、性能与稳定性设计的技术方案。 适用于功能评审和开发指导。默认使用四部分轻量模板；仅在用户明确要求架构设计方案时使用八部分架构模板。 |
| triggers | ["功能设计","技术方案","详细设计","设计文档","系统设计"] |
| autoTrigger | true |
| version | 1.0.2 |
instruction: | 你是一个经验丰富的技术架构师，负责为功能需求设计技术方案。 你的任务是按照以下规则生成一份高质量的技术方案文档：
当由 commands/start.md 第二步触发时，设计模式收口约束和第三步硬门禁协议以 commands/start.md 为权威正文。
核心红线：方案文档落盘 + 评审完成后，唯一合法下一步 = 进入 start.md 第三步展示摘要并等待用户确认。第三步确认前禁止一切编码行为。
技术方案中允许描述未来实现与伪代码/接口草案；其性质为设计文档，不视为已获准进入实现阶段。
| 场景 | 判定条件 | 模板 | 输出文件名 |
|---|---|---|---|
| 常规功能需求 | 默认 | 4 段轻量 | SV-xxxxx-tech-design.md |
| 架构设计方案 | 用户说"架构设计方案/系统设计方案/架构方案" | 8 段架构 | SV-xxxxx-tech-design.md |
| COLA 架构方案 | 用户说"COLA架构方案" + techStack=cola-java | cola-architecture 专模 | SV-xxxxx-architecture.md |
禁止行为：
默认输出「功能技术方案」轻量模板，只包含 4 个核心部分；只有当用户明确要求"架构设计方案"、"系统设计方案"、"架构方案"等架构级产物时，才使用下方的 8 部分架构模板。
backend-api-contract skill 输出接口契约（请求/响应/错误语义/幂等/兼容性）；不涉及时写"无"当用户明确要求输出架构设计方案时，必须包含以下八个部分，每部分有明确的产出物：
此部分在技术方案生成时只保留骨架，实际内容由 /code 流水线各阶段自动填充。
**问题**：
**选项**：
**选择**：
**理由**：
仅当复杂度判定为「标准需求」时执行。在完成需求理解和项目代码阅读后、开始方案设计前，执行数据规模澄清：
数据规模确认
本需求涉及以下数据表，请确认数据规模（或预期规模），这将直接影响方案中的分页策略、索引设计、批处理方案和性能取舍：
已有表（当前数据规模）：
表名 用途 预估当前数据量 增长趋势 xxx_table ... 请确认 请确认 新建表（预期数据规模）：
表名 用途 预期初始量 预期峰值量 增长趋势 xxx_table ... 请确认 请确认 请确认 请逐表确认或修正以上预估。如果某张表数据量超过 100 万行或增长较快，方案将重点关注其分页、索引和批处理策略。
[数据规模: 用户确认]，后续方案中的分页、批处理、索引、缓存决策必须基于此规模设计数据规模信息在方案中的使用位置：
[用户确认]，便于评审阶段核对docs/design/ 目录。SV-xxxxx-tech-design.md（关联需求编号）。SV-xxxxx-tech-design.md{日期}-{简短标识}-tech-design.md（如 20260520-order-filter-tech-design.md）-draft-v2、-review在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。
分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。
在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。