learn-skill

Analyze and learn any newly installed skill through two-layer Mermaid diagrams. Use when: user asks to parse/analyze a new skill, understand skill structure,...

Learn Skill - 通用技能分析工具

解析任意 Skill 的功能结构，生成可视化的双层架构图表。

核心方法：两层架构分析法

层次	关注点	产出物
规划层	技能定位、边界、输入要求	决策 flowchart、mindmap
绘制层	功能分解、用户交互、API调用	架构图、时序图、提问样例

使用方法

Step 1: 读取目标 Skill 的 SKILL.md

首先读取待分析技能的 SKILL.md 文件，了解其：

• description - 技能描述和触发场景
• 功能列表和命令示例

Step 2: 生成两层分析

根据 SKILL.md 内容，生成两层架构图表：

第一层（规划层）：

flowchart TB
    A["🔍 用户请求"] --> B{类型判断}
    B -->|匹配技能| C[✅ 使用该 Skill]
    B -->|不匹配| D[❌ 不适用]
    C --> E["📍 输入要求"]
    E --> F["调用 API/工具"]
    F --> G["返回结果"]
    
    style C fill:#00d9ff,color:#000
    style D fill:#ff6b6b,color:#fff

第二层（绘制层）：

• 用户提问样例 flowchart
• 核心功能架构图（命令类型 → 输出格式 → 格式化代码）
• 完整交互时序图

Step 3: 输出 HTML 报告

生成包含所有图表的 HTML 文件供用户查看。

HTML 输出规范（确保文字清晰可见）：

• 页面背景使用深色渐变时，正文文字使用浅色 #eee 或白色
• 表格使用白色背景 #fff + 深色文字 #1a1a2e 提供高对比度
• 代码块使用浅色背景（如 rgba(0,217,255,0.15)）+ 深色文字
• 标题使用渐变色或亮色（#00d9ff, #00ff88）确保与背景区分
• 图表容器使用白色背景避免与深色页面混色

---

示例：Weather Skill 分析

下面以 Weather Skill 为例，展示两层架构的完整输出。

第一层：规划层 - 技能定位与适用范围

flowchart TB
    A["🔍 用户查询天气"] --> B{查询类型判断}
    
    B -->|天气/温度/预报| C[✅ 使用 Weather Skill]
    B -->|历史数据| D[❌ 不适用]
    B -->|气候趋势分析| D
    B -->|极端天气警报| D
    B -->|航空/航海气象| D
    
    C --> E["📍 需要提供位置"]
    E --> F["城市名/地区/机场代码"]
    F --> G["调用 wttr.in API"]
    G --> H["返回天气数据"]
    
    style C fill:#00d9ff,color:#000
    style D fill:#ff6b6b,color:#fff

mindmap
  root((Weather Skill))
    适用场景
      当前天气查询
      温度询问
      降雨预测
      未来天气预报
      出行天气规划
    不适用场景
      历史天气数据
      气候趋势分析
      极端天气警报
      专业气象服务
    数据来源
      wttr.in
      Open-Meteo
    特殊要求
      需要提供位置信息
      支持城市名/机场码
      无需API密钥

第二层：绘制层 - 核心功能架构与提问样例

💬 用户提问样例

flowchart LR
    Q1["❓ '北京今天天气怎么样？'"] 
    Q2["❓ '东京明天会下雨吗？'"]
    Q3["❓ '上海周末温度多少？'"]
    Q4["❓ '伦敦下周天气预报'"]
    
    Q1 -->|城市+时间| R1["当前天气查询"]
    Q2 -->|城市+时间+降水| R2["降雨预测查询"]
    Q3 -->|城市+时间段| R3["周末预报查询"]
    Q4 -->|城市+时间范围| R4["周预报查询"]

⚙️ 核心功能架构

flowchart LR
    subgraph 命令类型
        A1["当前天气 curl wttr.in/London?format=3"] 
        A2["3天预报 curl wttr.in/London"]
        A3["一周预报 curl wttr.in/London?format=v2"]
        A4["指定日期 curl wttr.in/London?1"]
    end
    
    subgraph 输出格式
        B1["单行摘要 format=3"]
        B2["详细条件 ?0"]
        B3["JSON输出 format=j1"]
        B4["PNG图片 .png"]
    end
    
    subgraph 格式化代码
        C1["%l 位置"]
        C2["%c 天气状况"]
        C3["%t 温度"]
        C4["%f 体感温度"]
        C5["%w 风速"]
        C6["%h 湿度"]
        C7["%p 降水量"]
    end
    
    A1 --> B1
    A2 --> B2
    A3 --> B3
    A4 --> B4
    
    B1 --> C1
    B1 --> C2
    B1 --> C3

时序图 - 完整交互流程

sequenceDiagram
    participant U as 用户
    participant A as Agent
    participant W as wttr.in API
    
    U->>A: "伦敦天气怎么样？"
    A->>A: 识别为天气查询请求
    A->>W: curl "wttr.in/London?format=j1"
    W->>A: 返回JSON天气数据
    A->>A: 解析数据提取关键信息
    A->>U: 格式化回复 🌤️ 伦敦: 18°C 感觉像: 16°C 西风 12km/h 湿度 65%
    
    U->>A: "明天会下雨吗？"
    A->>W: curl "wttr.in/London?format=%p"
    W->>A: 返回降水信息
    A->>U: 降水概率回复

---

输出模板

当用户要求分析新 Skill 时，按以下格式组织输出：

# {Skill名称} 分析

## 第一层：规划层 - 技能定位与适用范围
[flowchart + mindmap]

## 第二层：绘制层 - 核心功能架构与提问样例
[用户提问样例 flowchart]
[核心功能架构图]
[时序图]

相关资源

• Mermaid 图表语法：mermaid-diagrams Skill
• 技能创建规范：skill-creator Skill