name: log-analysis-fault-mode description: 故障模式提炼器的适配器层。从日志表格中提炼故障模式,生成标准化故障模式库 CSV。触发词:提炼故障模式、生成故障模式库、故障模式库。 version: adaptor
故障模式提炼器(适配器)
本 skill 是适配器层,不存储故障模式库 schema 本身,而是定位外部 schema 文件并支持 custom schema 注入。
触发词
提炼故障模式、生成故障模式库、故障模式库
核心设计
外部 Schema 文件(Source of Truth)
↓
本适配器(加载 schema + 支持 custom override)
↓
故障模式生成工具(按 schema 输出 CSV)
- 外部版:默认 schema 在
external-schema.csv(30 列),支持用户注入 custom schema - 内部版(后续):公司正式故障模式库文档作为 Source of Truth,按公司字段口径生成 internal profile
Schema 文件路径
| 版本 | 文档位置 |
|---|---|
| 外部默认 Schema | ~/.hermes/skills/local/log-analysis/log-analysis-fault-mode/external-schema.csv |
Schema Profile 机制
默认行为
直接加载 external-schema.csv 作为 30 列故障模式库 schema。
Custom Schema 注入
用户可提供自定义 schema CSV(格式:列号,列名,说明,取值/示例),适配器会:
- 以
external-schema.csv为基础 - 合并用户提供的 custom schema
- 冲突时以 custom schema 为准
调用时指定 custom_schema_path 即可启用自定义 schema。
内部版(后续)
公司正式故障模式库文档 → internal profile → 按公司字段口径生成
调用方式
查看默认 Schema
读取 external-schema.csv 获取默认 30 列定义,包括:
- 列1-8:基本信息(编号、错误码、名称、一~五级分类)
- 列9-17:故障描述(原因、影响、爆炸半径、等级、分类、场景)
- 列18-27:检测与处理(检测机制、处理逻辑、恢复、构造、定位)
- 列28-30:辅助信息(使能条件、可定位性、自动化程度)
生成故障模式库
调用本 skill 时,传入:
- 校正后的日志表格(
log-analysis-correct输出) - 输出目录
- 功能名称
- 可选:
custom_schema_path指定自定义 schema
使用场景
| 场景 | 调用方式 |
|---|---|
| 生成标准故障模式库 | 加载默认 external-schema.csv |
| 使用自定义 schema | 指定 custom_schema_path 参数 |
| 公司内部使用 | 后续切换到 internal profile |
适配器职责
- 定位 schema 文件:找到对应版本的外部 schema 文件
- 支持 schema 合并:加载默认 schema 并合并 custom override
- 透传调用:将用户请求路由到故障模式生成能力
- 版本维护:当外部 schema 更新时,只需更新 external-schema.csv,本适配器无需改动