从一句话到几十份文档:用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 里。这符…

— 以上为试看内容(约 40%),开通会员后阅读全文 —