Skill: junwugit/learn-skill (version 1.0.0)

--- name: learn-skill description: | 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, or visualize skill capabilities. Triggers: "parse this skill", "analyze skill", "understand how this skill works", "learn skill". --- # Learn Skill - 通用技能分析工具 解析任意 Skill 的功能结构，生成可视化的双层架构图表。 ## 核心方法：两层架构分析法 | 层次 | 关注点 | 产出物 | |------|--------|--------| | **规划层** | 技能定位、边界、输入要求 | 决策 flowchart、mindmap | | **绘制层** | 功能分解、用户交互、API调用 | 架构图、时序图、提问样例 | ## 使用方法 ### Step 1: 读取目标 Skill 的 SKILL.md 首先读取待分析技能的 SKILL.md 文件，了解其： - `description` - 技能描述和触发场景 - 功能列表和命令示例 ### Step 2: 生成两层分析 根据 SKILL.md 内容，生成两层架构图表： **第一层（规划层）：** ```mermaid 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 为例，展示两层架构的完整输出。 ### 第一层：规划层 - 技能定位与适用范围 ```mermaid 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 ``` ```mermaid mindmap root((Weather Skill)) 适用场景 当前天气查询 温度询问 降雨预测 未来天气预报 出行天气规划 不适用场景 历史天气数据 气候趋势分析 极端天气警报 专业气象服务 数据来源 wttr.in Open-Meteo 特殊要求 需要提供位置信息 支持城市名/机场码 无需API密钥 ``` ### 第二层：绘制层 - 核心功能架构与提问样例 #### 💬 用户提问样例 ```mermaid flowchart LR Q1["❓ '北京今天天气怎么样？'"] Q2["❓ '东京明天会下雨吗？'"] Q3["❓ '上海周末温度多少？'"] Q4["❓ '伦敦下周天气预报'"] Q1 -->|城市+时间| R1["当前天气查询"] Q2 -->|城市+时间+降水| R2["降雨预测查询"] Q3 -->|城市+时间段| R3["周末预报查询"] Q4 -->|城市+时间范围| R4["周预报查询"] ``` #### ⚙️ 核心功能架构 ```mermaid 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 ``` #### 时序图 - 完整交互流程 ```mermaid 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)