القائمة
数据可视化和仪表盘设计时使用。适用于图表选型、仪表盘布局、BI 工具使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
设计 API 认证鉴权和权限矩阵时使用。适用于多角色系统、租户隔离、字段级权限。优先使用 OAuth 2.0 / JWT + RBAC + 资源归属检查。
设计具体 API 端点时使用。适用于资源建模后的下一步、列端点清单、HTTP 方法和状态码选择。优先使用 RFC 7231 HTTP 语义 + GitHub REST 命名规范。
设计 API 错误码和错误结构时使用。适用于错误响应规范、调用方错误处理、调试可观测。优先使用 RFC 7807 Problem Details + 业务错误码 + 调用方处理建议。
设计幂等接口和重试策略时使用。适用于支付、扣减、订单、关键写操作。优先使用 Idempotency-Key + 业务去重键 + 并发冲突处理（ETag/版本号）。
输出 OpenAPI 契约和 Mock 服务时使用。适用于 API 设计的最后一步、给前端/后端/QA 的交付。优先使用 OpenAPI 3.1 + Mock 数据覆盖所有路径 + 详细的下游交接清单。
设计列表接口的分页、筛选、排序、搜索时使用。适用于所有列表 API。优先使用 cursor 分页（大数据）或 offset 分页（小数据）+ 统一筛选/排序规范。
| name | data-visualization |
| description | 数据可视化和仪表盘设计时使用。适用于图表选型、仪表盘布局、BI 工具使用。 |
1. 图表服务于问题
先有问题再选图表
2. 简洁优先
不要 3D / 彩虹色 / 动画
3. 受众决定复杂度
管理层看 KPI 大数字
分析师看明细交互
4. 对比是可视化之魂
同比 / 环比 / 基线 / 目标线
| 数据关系 | 推荐图表 |
|---|---|
| 趋势 | 折线图 |
| 对比 | 柱状图 |
| 占比 | 饼图（≤5 类）/ 堆叠柱状 |
| 分布 | 直方图 / 箱线图 |
| 相关 | 散点图 |
| 漏斗 | 漏斗图 |
| 排名 | 水平条形图 |
| 地理 | 地图 |
| 工具 | 适合 |
|---|---|
| Metabase | 开源 / 自助 BI |
| Apache Superset | 开源 / 功能全 |
| Grafana | 运维 / 实时 |
| Looker | Google 企业 |
| Tableau | 商业智能标杆 |
| Power BI | 微软生态 |
| ECharts | 前端嵌入 |
| Recharts | React 简单图表 |
templates/dashboard-template.md — 仪表盘设计模板□ 图表服务于问题
□ 选型合适
□ 简洁不花哨
□ 有对比基线
□ 有时间筛选
□ 受众匹配
□ 移动端可看
上游：sql-analysis → 数据查询
下游：analysis-report → 配图