refactor: 重构 skill 为符合规范的 SKILL.md 结构

2026-04-16 05:24:02 +08:00
parent 97558edad5
commit c603ea8999
3 changed files with 232 additions and 205 deletions
--- a/skill.md
+++ b/skill.md
@@ -1,205 +0,0 @@
-# Chart Skill - 图表生成工具
-
-## 概述
-
-用于生成各种类型的图表，返回多种格式以适配不同场景：
- **ANSI 格式**：终端彩色显示
- **SVG 格式**：Web 内嵌矢量图
- **PNG 格式**：位图下载
- **Markdown 格式**：Web 对话窗口显示
-
-## 支持的图表类型
-
-| 类型 | 说明 |
-|------|------|
-| `line` | 折线图 |
-| `bar` | 柱状图 |
-| `pie` | 饼图 |
-| `scatter` | 散点图 |
-| `bubble` | 气泡图 |
-| `donut` | 圆环图 |
-| `mixed` | 混合图（柱状+折线） |
-| `polar` | 极区图 |
-| `radar` | 雷达图 |
-
-## 基本信息
-
-| 属性 | 值 |
-|------|-----|
-| 端点 | `http://localhost:3100/api/v1/chart` |
-| 方法 | `POST` |
-| 内容类型 | `application/json` |
-
-## 请求参数
-
-### 参数结构
-
-```json
-{
-  "type": "bar",
-  "title": "图表标题",
-  "data": {
-    "labels": ["标签1", "标签2", "标签3"],
-    "datasets": [
-      {
-        "name": "数据系列名称",
-        "values": [100, 150, 120],
-        "color": "#4CAF50"
-      }
-    ],
-    "options": {
-      "width": 600,
-      "height": 400
-    }
-  }
-}
-```
-
-### 参数说明
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `type` | string | 否 | 图表类型，默认 `line` |
-| `title` | string | 否 | 图表标题 |
-| `data.labels` | array | 是 | 标签数组 |
-| `data.datasets` | array | 是 | 数据系列数组 |
-| `datasets[].name` | string | 否 | 数据系列名称 |
-| `datasets[].values` | array | **是** | 数值数组 |
-| `datasets[].color` | string | 否 | 十六进制颜色，如 `#4CAF50` |
-| `options.width` | integer | 否 | 图表宽度（像素） |
-| `options.height` | integer | 否 | 图表高度（像素） |
-
-## 响应字段
-
-| 字段 | 说明 |
-|------|------|
-| `chart_id` | 图表唯一标识 |
-| `text` | 纯文本描述 |
-| `ansi` | ANSI 彩色文本（用于终端） |
-| `svg` | SVG 矢量图代码 |
-| `png_url` | PNG 图片下载 URL |
-| `markdown` | Markdown 格式（用于 Web） |
-
-## 使用示例
-
-### 示例 1：柱状图
-
-```json
-{
-  "type": "bar",
-  "title": "月度销售额",
-  "data": {
-    "labels": ["一月", "二月", "三月", "四月"],
-    "datasets": [
-      { "name": "销售额", "values": [100, 150, 120, 180], "color": "#4CAF50" }
-    ]
-  }
-}
-```
-
-### 示例 2：饼图
-
-```json
-{
-  "type": "pie",
-  "title": "市场份额",
-  "data": {
-    "labels": ["苹果", "三星", "华为", "其他"],
-    "datasets": [
-      { "name": "销量", "values": [35, 25, 20, 20] }
-    ]
-  }
-}
-```
-
-### 示例 3：圆环图
-
-```json
-{
-  "type": "donut",
-  "title": "预算分配",
-  "data": {
-    "labels": ["人力", "设备", "营销", "研发"],
-    "datasets": [
-      { "name": "预算", "values": [40, 20, 25, 15], "color": "#2196F3" }
-    ]
-  }
-}
-```
-
-### 示例 4：雷达图
-
-```json
-{
-  "type": "radar",
-  "title": "员工能力评估",
-  "data": {
-    "labels": ["速度", "力量", "耐力", "智力", "敏捷"],
-    "datasets": [
-      { "name": "张三", "values": [80, 70, 90, 85, 75] }
-    ]
-  }
-}
-```
-
-### 示例 5：气泡图
-
-```json
-{
-  "type": "bubble",
-  "title": "产品分析",
-  "data": {
-    "labels": ["产品A", "产品B", "产品C", "产品D"],
-    "datasets": [
-      { "name": "销量/利润", "values": [100, 250, 150, 300] }
-    ]
-  }
-}
-```
-
-### 示例 6：混合图
-
-```json
-{
-  "type": "mixed",
-  "title": "销售与目标对比",
-  "data": {
-    "labels": ["一月", "二月", "三月", "四月"],
-    "datasets": [
-      { "name": "实际", "values": [100, 150, 120, 180] },
-      { "name": "目标", "values": [120, 140, 130, 160] }
-    ]
-  }
-}
-```
-
-### 示例 7：极区图
-
-```json
-{
-  "type": "polar",
-  "title": "风向分布",
-  "data": {
-    "labels": ["北", "东北", "东", "东南", "南"],
-    "datasets": [
-      { "name": "风速", "values": [10, 20, 15, 25, 30] }
-    ]
-  }
-}
-```
-
-## 使用场景
-
-| 场景 | 推荐字段 | 说明 |
-|------|---------|------|
-| 终端显示 | `ansi` | 彩色 ASCII 图表 |
-| Web 内嵌 | `svg` | 内联 SVG 代码 |
-| Web 展示 | `markdown` | 图片链接 |
-| 文件下载 | `png_url` | 下载 PNG 文件 |
-
-## 注意事项
-
-1. 每次请求生成新的图表，图表会缓存在服务器内存中
-2. 图表数据通过 `datasets[].values` 传递，支持多系列
-3. 颜色使用十六进制格式，如 `#FF5722`
-4. 终端使用 ANSI 格式，Web 使用 Markdown 格式
--- a/skills/picoclaw-chart/SKILL.md
+++ b/skills/picoclaw-chart/SKILL.md
@@ -0,0 +1,72 @@
+---
+name: picoclaw-chart
+description: 生成多种格式的图表（ANSI/SVG/PNG/Markdown）。支持折线图、柱状图、饼图、散点图、气泡图、圆环图、混合图、极区图、雷达图。用于 (1) 终端彩色显示, (2) Web 内嵌矢量图, (3) 位图下载, (4) Markdown 文档嵌入
+---
+
+# Chart Skill
+
+## 快速开始
+
+```json
+POST https://aipi.gaomia.site/api/v1/chart
+{
+  "type": "bar",
+  "title": "月度销售额",
+  "data": {
+    "labels": ["一月", "二月", "三月"],
+    "datasets": [
+      { "name": "销售额", "values": [100, 150, 120], "color": "#4CAF50" }
+    ]
+  }
+}
+```
+
+响应：
+```json
+{
+  "chart_id": "string",
+  "text": "纯文本描述",
+  "ansi": "ANSI 彩色文本",
+  "svg": "SVG 矢量图",
+  "png_url": "https://aipi.gaomia.site/chart/{id}.png",
+  "markdown": "![标题](url)"
+}
+```
+
+## 图表类型
+
+| type | 说明 |
+|------|------|
+| `line` | 折线图 |
+| `bar` | 柱状图 |
+| `pie` | 饼图 |
+| `scatter` | 散点图 |
+| `bubble` | 气泡图 |
+| `donut` | 圆环图 |
+| `mixed` | 混合图（柱状+折线） |
+| `polar` | 极区图 |
+| `radar` | 雷达图 |
+
+## 输出格式选择
+
+| 场景 | 使用字段 |
+|------|----------|
+| 终端显示 | `ansi` |
+| Web 内嵌 | `svg` |
+| Web 展示 | `markdown` |
+| 文件下载 | `png_url` |
+
+## 参数参考
+
+| 字段 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| `type` | string | 否 | `line` |
+| `title` | string | 否 | - |
+| `data.labels` | array | 是 | - |
+| `data.datasets[].name` | string | 否 | - |
+| `data.datasets[].values` | array | **是** | - |
+| `data.datasets[].color` | string | 否 | `#4CAF50` |
+| `data.options.width` | int | 否 | 600 |
+| `data.options.height` | int | 否 | 400 |
+
+详细 API 文档：见 [CHART_API.md](references/CHART_API.md)
--- a/skills/picoclaw-chart/references/CHART_API.md
+++ b/skills/picoclaw-chart/references/CHART_API.md
@@ -0,0 +1,160 @@
+# Chart API 详细文档
+
+## 端点
+
+| 项目 | 值 |
+|------|-----|
+| 地址 | `https://aipi.gaomia.site/api/v1/chart` |
+| 方法 | `POST` |
+| Content-Type | `application/json` |
+
+## 请求结构
+
+```json
+{
+  "type": "bar",
+  "title": "图表标题",
+  "data": {
+    "labels": ["标签1", "标签2", "标签3"],
+    "datasets": [
+      {
+        "name": "数据系列名称",
+        "values": [100, 150, 120],
+        "color": "#4CAF50"
+      }
+    ],
+    "options": {
+      "width": 600,
+      "height": 400
+    }
+  }
+}
+```
+
+## 响应结构
+
+```json
+{
+  "chart_id": "abc123",
+  "text": "纯文本描述",
+  "ansi": "\u001b[31m红色文本\u001b[0m",
+  "svg": "<svg>...</svg>",
+  "png_url": "https://aipi.gaomia.site/chart/abc123.png",
+  "markdown": "![月度销售额](https://aipi.gaomia.site/chart/abc123.png)"
+}
+```
+
+## 图表类型示例
+
+### 柱状图 (bar)
+
+```json
+{
+  "type": "bar",
+  "title": "月度销售额",
+  "data": {
+    "labels": ["一月", "二月", "三月", "四月"],
+    "datasets": [
+      { "name": "销售额", "values": [100, 150, 120, 180], "color": "#4CAF50" }
+    ]
+  }
+}
+```
+
+### 饼图 (pie)
+
+```json
+{
+  "type": "pie",
+  "title": "市场份额",
+  "data": {
+    "labels": ["苹果", "三星", "华为", "其他"],
+    "datasets": [
+      { "name": "销量", "values": [35, 25, 20, 20] }
+    ]
+  }
+}
+```
+
+### 圆环图 (donut)
+
+```json
+{
+  "type": "donut",
+  "title": "预算分配",
+  "data": {
+    "labels": ["人力", "设备", "营销", "研发"],
+    "datasets": [
+      { "name": "预算", "values": [40, 20, 25, 15], "color": "#2196F3" }
+    ]
+  }
+}
+```
+
+### 雷达图 (radar)
+
+```json
+{
+  "type": "radar",
+  "title": "员工能力评估",
+  "data": {
+    "labels": ["速度", "力量", "耐力", "智力", "敏捷"],
+    "datasets": [
+      { "name": "张三", "values": [80, 70, 90, 85, 75] }
+    ]
+  }
+}
+```
+
+### 气泡图 (bubble)
+
+```json
+{
+  "type": "bubble",
+  "title": "产品分析",
+  "data": {
+    "labels": ["产品A", "产品B", "产品C", "产品D"],
+    "datasets": [
+      { "name": "销量/利润", "values": [100, 250, 150, 300] }
+    ]
+  }
+}
+```
+
+### 混合图 (mixed)
+
+```json
+{
+  "type": "mixed",
+  "title": "销售与目标对比",
+  "data": {
+    "labels": ["一月", "二月", "三月", "四月"],
+    "datasets": [
+      { "name": "实际", "values": [100, 150, 120, 180] },
+      { "name": "目标", "values": [120, 140, 130, 160] }
+    ]
+  }
+}
+```
+
+### 极区图 (polar)
+
+```json
+{
+  "type": "polar",
+  "title": "风向分布",
+  "data": {
+    "labels": ["北", "东北", "东", "东南", "南"],
+    "datasets": [
+      { "name": "风速", "values": [10, 20, 15, 25, 30] }
+    ]
+  }
+}
+```
+
+## 注意事项
+
+1. 每次请求生<E6B182><E7949F><EFBFBD>新的图表，图表会缓存在服务器内存中
+2. 图表数据通过 `datasets[].values` 传递，支持多系列
+3. 颜色使用十六进制格式，如 `#FF5722`
+4. 终端使用 ANSI 格式，Web 使用 Markdown 格式