# Tech Design

> 通用技术方案撰写技能。根据需求输入（需求分析报告或口头描述）自动生成结构完整的技术方案 Markdown 文档。当用户说"帮我写技术方案"、"出一个技术设计文档"、"写一份 design doc"、"给这个需求出方案"时使用本技能。

- Skill: `tencent/tech-design` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tencent/tech-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencent/tech-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tencent (https://skillmd.com/u/tencent)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tencent/tech-design

---


# 技术方案撰写技能

## 工作流程

### 第一步：解析需求输入

根据输入类型进行处理：

- **需求分析报告**：读取报告文件，提取需求背景、功能点、约束条件
- **口头描述**：直接理解用户描述，若信息不足以支撑方案撰写，追问以下关键信息：
  - 核心功能是什么？
  - 涉及哪些系统/模块？
  - 有无性能/安全特殊要求？
  - 预计数据量级？

### 第二步：加载方案模板

读取通用技术方案模板：[references/general.md](references/general.md)

### 第三步：撰写技术方案

按照模板结构生成技术方案，注意：

- 架构图、流程图、时序图统一使用 Mermaid 语法绘制
- 不涉及的章节（如灰度策略、第三方依赖）直接删除，不强行填写
- 若某章节信息不足，标注"待补充"并说明需要哪些信息
- 方案中的估算数据（性能指标、数据量等）需标注来源或假设依据

### 第四步：保存文档

将生成的技术方案保存为 Markdown 文件：

- 若用户已指定输出路径，保存到指定路径
- 若用户未指定路径，询问保存位置
- 文件名建议：`tech-design-[需求名称].md`

## 注意事项

- 方案内容应具体、可落地，避免空泛描述
- 关键技术决策需说明"为什么选这个，为什么不选那个"
- 复杂方案优先用图表表达，文字辅助说明