00.基础入门大模型学习Skills

Agent, Skill

2026-03-18

...

整站

Skill案例 - tech-solution

技术方案生成

版本：v1.0
更新日期：2026-03-18

生成结构化的技术方案文档，适用于项目立项、技术评审、方案汇报等场景。

使用方式

1	/tech-solution [方案主题]

参数说明：

方案主题：可选，指定方案的主题名称

触发规则

当用户提到以下关键词时自动触发：

“技术方案”
“方案设计”
“技术设计”
“架构方案”

输出规范

基本原则

使用 Markdown 格式
结构清晰，层次分明
技术术语准确
图表使用 SVG 格式

文档结构

# 技术方案：{方案名称}

## 一、方案概述
├── 1.1 背景与目标
├── 1.2 问题分析
└── 1.3 预期收益

## 二、整体设计
├── 2.1 架构设计
├── 2.2 技术选型
└── 2.3 关键技术

## 三、详细设计
├── 3.1 模块划分
├── 3.2 接口设计
├── 3.3 数据设计
└── 3.4 安全设计

## 四、实施计划
├── 4.1 阶段划分
├── 4.2 里程碑
└── 4.3 资源需求

## 五、风险与应对
├── 5.1 风险识别
└── 5.2 应对措施

## 六、附录
├── 6.1 术语说明
└── 6.2 参考资料

表格格式

使用 HTML 表格，第一列橙红色粗体：

<table class="_table" style="width: 75%">
  <thead>
    <tr>
      <th>维度</th>
      <th>说明</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong style="color: #C15F3C">示例项</strong></td>
      <td>示例内容</td>
    </tr>
  </tbody>
</table>

架构图格式

使用 SVG 绘制架构图，配色建议：

元素类型	颜色	用途
蓝色 `#3b82f6`	核心模块	主要功能组件
绿色 `#10b981`	数据层	数据库、缓存
紫色 `#8b5cf6`	服务层	API、微服务
橙色 `#f59e0b`	外部依赖	第三方服务

详细规范

一、方案概述

1.1 背景与目标

必须包含：

项目背景（为什么做）
业务目标（达成什么）
技术目标（解决什么技术问题）

格式示例：

### 1.1 背景与目标

**背景**：
{背景描述}

**业务目标**：
- 目标1
- 目标2

**技术目标**：
- 目标1
- 目标2

1.2 问题分析

使用表格描述问题：

问题类型	问题描述	影响范围
性能问题	问题详细描述	影响范围说明
扩展性问题	问题详细描述	影响范围说明

1.3 预期收益

分类描述收益：

收益类型	具体收益	量化指标
业务收益	收益描述	可量化的指标
技术收益	收益描述	可量化的指标

二、整体设计

2.1 架构设计

必须包含：

架构图（SVG）
架构说明
核心流程

架构图示例：

<svg viewBox="0 0 900 400" xmlns="http://www.w3.org/2000/svg">
  <rect width="900" height="400" fill="#f8fafc"/>

  <!-- 标题 -->
  <text x="450" y="30" text-anchor="middle" fill="#1e293b" font-family="system-ui" font-size="16" font-weight="bold">系统架构图</text>

  <!-- 接入层 -->
  <rect x="50" y="60" width="800" height="60" rx="8" fill="#eff6ff" stroke="#3b82f6" stroke-width="2"/>
  <text x="450" y="95" text-anchor="middle" fill="#1e40af" font-family="system-ui" font-size="14" font-weight="bold">接入层</text>

  <!-- 应用层 -->
  <rect x="50" y="140" width="800" height="100" rx="8" fill="#f5f3ff" stroke="#8b5cf6" stroke-width="2"/>
  <text x="450" y="170" text-anchor="middle" fill="#5b21b6" font-family="system-ui" font-size="14" font-weight="bold">应用层</text>

  <!-- 数据层 -->
  <rect x="50" y="260" width="800" height="60" rx="8" fill="#f0fdf4" stroke="#10b981" stroke-width="2"/>
  <text x="450" y="295" text-anchor="middle" fill="#166534" font-family="system-ui" font-size="14" font-weight="bold">数据层</text>
</svg>

2.2 技术选型

使用对比表格：

技术领域	选型方案	选型理由	备选方案
后端框架	Spring Boot 3.x	生态成熟、团队熟悉	Go Gin
数据库	MySQL 8.0	稳定可靠、运维成熟	PostgreSQL
缓存	Redis 7.x	高性能、功能丰富	Memcached

2.3 关键技术

关键技术点
├── 技术点1：{技术名称}
│   ├── 应用场景：{场景描述}
│   ├── 实现方案：{方案描述}
│   └── 预期效果：{效果描述}
├── 技术点2：{技术名称}
│   ├── 应用场景
│   ├── 实现方案
│   └── 预期效果
└── 技术点3：{技术名称}
    └── ...

三、详细设计

3.1 模块划分

模块名称	职责说明	依赖模块
用户模块	用户注册、登录、权限管理	认证模块
订单模块	订单创建、查询、状态管理	用户模块、支付模块

3.2 接口设计

接口文档格式：

### 接口：{接口名称}

**请求信息**

| 属性 | 值 |
|------|-----|
| URL | /api/v1/resource |
| Method | POST |
| Content-Type | application/json |

**请求参数**

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| param1 | string | 是 | 参数说明 |

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| code | number | 状态码 |
| data | object | 返回数据 |

3.3 数据设计

ER 图使用 SVG：

数据表设计格式：

字段名	类型	说明	索引
id	BIGINT	主键	PK
name	VARCHAR(100)	名称	INDEX

3.4 安全设计

安全设计
├── 认证与授权
│   ├── 认证方式：JWT / OAuth2
│   ├── 权限控制：RBAC 模型
│   └── 会话管理：Redis 存储
├── 数据安全
│   ├── 敏感数据加密：AES-256
│   ├── 传输加密：HTTPS
│   └── 数据脱敏：日志、展示
└── 接口安全
    ├── 参数校验
    ├── 防重放攻击
    └── 限流保护

四、实施计划

4.1 阶段划分

阶段	时间	主要任务	交付物
第一阶段	Week 1-2	基础架构搭建	项目脚手架、CI/CD
第二阶段	Week 3-4	核心功能开发	核心模块代码
第三阶段	Week 5-6	测试与优化	测试报告、优化方案

4.2 里程碑

使用 SVG 绘制里程碑图：

<svg viewBox="0 0 900 150" xmlns="http://www.w3.org/2000/svg">
  <rect width="900" height="150" fill="#f8fafc"/>

  <!-- 时间轴 -->
  <line x1="50" y1="75" x2="850" y2="75" stroke="#cbd5e1" stroke-width="3"/>

  <!-- 里程碑节点 -->
  <circle cx="150" cy="75" r="12" fill="#3b82f6"/>
  <text x="150" y="110" text-anchor="middle" fill="#334155" font-family="system-ui" font-size="12">M1: 架构完成</text>

  <circle cx="350" cy="75" r="12" fill="#8b5cf6"/>
  <text x="350" y="110" text-anchor="middle" fill="#334155" font-family="system-ui" font-size="12">M2: 核心功能</text>

  <circle cx="550" cy="75" r="12" fill="#f59e0b"/>
  <text x="550" y="110" text-anchor="middle" fill="#334155" font-family="system-ui" font-size="12">M3: 测试完成</text>

  <circle cx="750" cy="75" r="12" fill="#10b981"/>
  <text x="750" y="110" text-anchor="middle" fill="#334155" font-family="system-ui" font-size="12">M4: 上线</text>
</svg>

4.3 资源需求

资源类型	需求数量	说明
开发人员	3人	后端2人、前端1人
测试人员	1人	功能测试、性能测试
服务器	4台	2台应用、1台数据库、1台缓存

五、风险与应对

5.1 风险识别

风险类别	风险描述	影响程度	发生概率
技术风险	新技术学习成本高	中	中
进度风险	需求变更导致延期	高	中
资源风险	人员流动	高	低

5.2 应对措施

风险	应对措施	负责人
技术风险	提前进行技术预研，准备备选方案	技术负责人
进度风险	建立需求变更流程，预留缓冲时间	项目经理

示例

示例输入

1	/tech-solution 用户认证系统

示例输出

技术方案：用户认证系统

一、方案概述

1.1 背景与目标

背景：
现有系统使用简单的用户名密码认证，存在安全风险，且无法支持多端登录、第三方登录等需求。

业务目标：

支持多端登录（Web、App、小程序）
支持第三方登录（微信、支付宝）
提升账户安全性

技术目标：

构建统一认证中心
实现 OAuth2.0 标准协议
支持高并发场景

1.2 问题分析

问题类型	问题描述	影响范围
安全问题	密码明文存储，存在泄露风险	所有用户账户
扩展性问题	无法支持第三方登录	新用户注册转化率

（后续章节按规范继续…）

Skill 版本：v1.0
更新日期：2026-03-18
适用场景：项目立项、技术评审、方案汇报