用途:面向运维组织,解决知识库散乱问题——无人负责、缺少复核日期、成功信号模糊、缺少回滚路径、孤儿页面、术语漂移、仅覆盖正常流程等。用于编写跨职能 SOP、上线前校验 runbook、导入多文档知识库并生成健康报告、新人入职材料、季度清理冲刺。
主要能力:kb_ingester.py 遍历 markdown 目录,输出交叉链接图、术语候选与漂移、孤儿页、陈旧页(默认超 12 个月未编辑,可用 --stale-days 覆盖)、缺失负责人页,并生成按陈旧度×入链数排序的前 20 清理清单。runbook_validator.py 针对每步六项检查(具名负责人、预期时长、可观察成功信号、可观察失败信号、回滚路径、升级联系人),输出红黄绿标记、0-100 有效性评分和必改清单,≥80 可用、60-79 谨慎、<60 不安全。sop_generator.py 读取 JSON 元数据,按 --profile(ops/support/finance/hr/it/regulated)输出 5W2H 结构 SOP,regulated 增加版本控制、签署和审计追踪。
使用方式:按 kb_ingester.py --input <vault-dir> → runbook_validator.py --input <runbook.md> → sop_generator.py --input <metadata.json> --profile <profile> 顺序执行。示例:cd business-operations/skills/knowledge-ops && python3 scripts/kb_ingester.py --sample。
限制:知识库需为 markdown(或可导出为 markdown),纯 HTML/PDF 需先转换;负责人元数据需写在 YAML frontmatter 或页首 Owner 行;校验器只查结构不查内容正确性;孤儿页是优先级队列而非删除清单;不替代正式监管审计。个人 PKM、系统排障 runbook、项目管理、BPMN 流程设计均不属于本技能范围。