메뉴
针对具体功能需求，生成聚焦业务逻辑、数据流转、性能与稳定性设计的技术方案。 适用于功能评审和开发指导。默认使用四部分轻量模板；仅在用户明确要求架构设计方案时使用八部分架构模板。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。
分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。
在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。
| 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