从一句话到几十份文档:用Skill-insight的生成企业级Skill
一篇文档生成一个Skill只是入门。当你有几十份故障记录、上百页操作手册时,怎么把它们浓缩成一个精准的领域Skill?Skill-insight就是答案。
一、从入门到进阶:当输入不再"恰好是一份文档"
第1篇里,我们用一份Git Commit规范文档走通了从文档到Skill的全流程:安装平台、一句话生成、质量验证、执行评测。
但真实工作中,输入很少像"一份写好的规范文档"那样整齐。更多时候你面对的是这些情况:
"帮我做个Kafka排查的Skill,我们线上最近老出问题。"
"这三年攒了20份MySQL慢查询复盘,能不能提炼成一套通用的排查技能?"
"我手头有份故障模式表,但不够全,你能帮我扩展一下吗?"
第1篇解决的是"一份文档 → 一个Skill"。但如果输入是模糊的一句话、散乱的十几份记录、或者半成品的表格,怎么办?
本篇就回答这一个问题:手头资料形态各异,怎么稳定输出高质量的Skill?
答案在Skill-insight两种能力上:扩展(Expand) 和 归纳(Induce)。它们覆盖了从"一句话"到"几十份文档"之间的所有输入形态。
二、核心能力:扩展 vs 归纳
Skill-insight的生成路径,本质上就是这两种信息流动方向的组合:
能力 | 输入特征 | 输出特征 | Skill-insight在做什么 |
扩展(Expand) | 简短:一句话 / 一个主题 / 一个领域名 | 丰富:一张故障模式表 / 多个子场景 / 多个排查脚本 | 调用搜索与领域知识,把稀疏的需求展开成完整的知识结构 |
归纳(Induce) | 繁杂:多份案例 / 多份问题单 / 大量散乱记录 | 简洁:一个或多个共性故障模式 + 差异维度 | 逐份提取案例,交叉比对合并相同的故障机制,记录变化维度 |
2.1 扩展能力
适用场景:你心里大概知道想要什么,但缺少具体的经验文档或故障模式列表。
典型入口语句:
"帮我做一个Kafka排查的Skill。""做个Code Review checklist的skill。""帮我生成一个分析vmcore的skill,主要用来排查OOM、死锁、内核崩溃和硬件报错等常见故障。"
Skill-insight会先搜索这个领域的常见故障 / 操作,扩展出一张候选模式表(5-10项),呈现给你确认增删。确认后再走完整生成流程。
2.2 归纳能力
适用场景:你手头有多份相近的真实案例(问题单、排障记录、复盘文档),想从里面"抽出共性"做成可复用的Skill。
典型入口语句:
"请基于以下三个故障问题单生成一个统一的排查Skill。""从这些OOM领域经验文件里总结一个通用的内存故障排查Skill。"
Skill-insight会逐份提取案例(提炼现象 / 时间线 / 关键证据 / 排查步骤),然后交叉比对,将相同机制的合并成一个故障模式。这一步对应入门篇里讲的"去冗余、合相似、抽模式"。
2.3 两个能力,一个流程
不管输入走扩展还是归纳,后续流程是统一的:
扩展输入 ──┐ ├──→ 故障模式列表 ──→ 质量扫描 ──→ 搜索补全 ──→ 审核 ──→ 生成Skill归纳抽取 ──┘
生成路径由Skill-insight自己根据输入识别,不需要你选"模式"或切换开关。只管把手头有的东西丢过去就行。
下面两个案例将分别展示扩展和归纳的实际工作方式。
三、准备工作
3.1 环境
环境安装与第1篇完全相同。如果还没有安装,打开终端执行:
npx @witty-ai/skill-insight install
安装完成后在OpenCode中注册Skill工具包:
npx skills add https://gitcode.com/openeuler/witty-skill-insight.git
按指引选择 skill-generator,并选择你的集成框架(如OpenCode)。
如果环境已就绪,可跳过此节直接进入案例。
3.2 输入类型速查
下面任意一种输入都可以。输入越具体,生成的Skill越精确——但最低门槛就是一句话。
输入类型 | 触发能力 | 示例 |
一句话需求 | 扩展 | "帮我做一个vmcore排查的skill" |
一个领域名 | 扩展 | "Kafka排查"、"K8s网络故障" |
单份文档(PDF/MD/TXT) | 扩展 | 一份故障案例PDF |
一张故障模式表(结构化) | 直采 | 已整理好的markdown表格 |
多份相近案例 | 归纳 | 3份问题单 |
上述任意组合 | 混合 | 已有模式列表 + 补充的案例文档 |
四、案例一:一句话扩展——vmcore分析Skill
vmcore分析涉及多种互不相同的故障类别:内核崩溃、OOM、死锁、网络挂死、文件系统异常、硬件错误。每类的排查命令和判据都不一样。让人从零写一份覆盖全部的Skill,光梳理结构就要好几天。
但在Skill-insight里,只需要一句话。
输入
在OpenCode终端中输入:
帮我生成一个分析vmcore的skill,主要用来排查OOM、死锁、内核崩溃和硬件报错等常见故障。
Skill-insight会自动识别这是一条"扩展"类需求——输入稀疏,没有现成文档。它会先搜索vmcore相关的常见故障模式,列出一张候选表请你确认。确认后进入完整生成流程。
如果你想跳过交互确认:
帮我生成一个分析vmcore的skill,主要用来排查OOM、死锁、内核崩溃和硬件报错等常见故障,使用自动模式,不要交互。
生成的Skill
vmcore-fault-diagnosis/├── SKILL.md # 定义4步分析工作流和6种故障模式识别方法的主文档├── scripts/ # 7个故障排查脚本│ ├── collect.sh # 收集vmcore元数据、系统信息和内核日志的总入口脚本│ ├── check_hardware_fault.sh # 检测MCE/ECC内存错误等硬件故障│ ├── check_kernel_panic.sh # 分析panic消息和调用栈定位内核bug│ ├── check_deadlock.sh # 检测spinlock/mutex等同步机制死锁│ ├── check_oom_killer.sh # 分析内存耗竭和OOM killer触发原因│ ├── check_soft_lockup.sh # 检测长时间占用CPU的软锁定故障│ └── check_hard_lockup.sh # 检测CPU完全无响应的硬锁定故障└── references/ # 6个故障模式详解文档 ├── hardware_fault.md ├── kernel_panic.md ├── deadlock.md ├── oom_killer.md ├── soft_lockup.md └── hard_lockup.md
一句"帮我生成一个分析vmcore的skill" → 14个文件、68 KB的专业故障诊断Skill。
SKILL.md主体是4步分析工作流(信息采集 → 故障模式识别 → 场景细化与排查 → 兜底)。每个故障模式包含典型现象、关键判据和排查脚本概述,完整的子场景区分和排查建议放在对应的 references/{fault_mode}.md 里。这符…