| name | sop-extractor |
| description | SOP标准化流程提取器 — 将用户口述/转录的操作流程自动整理为标准SOP文档（含步骤、注意事项、所需工具、检查点），支持多维度质量评分、缺口分析、冗余检测、改进建议和多格式输出（Markdown/HTML/流程图/检查清单/培训卡片）。适用场景：经验沉淀、新人培训、流程标准化、外包交接、AI Agent 工作流定义。 |
| agent_created | true |
SOP 标准化流程提取器
快速开始（30秒入门）
最快触发方式（直接复制粘贴给 AI）：
帮我把这个流程整理成SOP：[粘贴你的操作描述]
帮我沉淀一下[客服处理/内容发布/软件部署]的流程
我要给新人写一份[岗位名称]的操作手册，帮我整理成标准化文档
把下面这段操作记录结构化：[粘贴文字]
一句话版：把口述/文字描述扔给我，自动出SOP文档、质量评分、检查清单和流程图。
增值效果：平均节省 80% 的文档整理时间，步骤覆盖率从人工整理的 60% 提升至 90% 以上，自动发现 3-5 个常被遗漏的检查点。
概述
将脑子里零散的操作经验一键转化为标准化SOP文档。用户只需口述流程（或上传转录文本），AI 自动完成：
- 🔍 智能解析：识别步骤边界、操作类型、决策点、检查点
- 📊 质量评估：7维度百分制评分（完整性/清晰度/可操作性/安全性/可度量性/效率/可维护性）
- 🔬 缺口分析：自动检测缺少的前置条件、检查点、注意事项、异常处理等
- ⚡ 效率优化：冗余检测、瓶颈识别、并行化建议、自动化建议
- 📦 多格式输出：交互HTML、Markdown、Mermaid流程图、执行检查清单、培训卡片
触发条件
当用户执行以下操作时自动加载：
明确触发（高置信度）：
- 说"帮我把这个流程整理成SOP"
- 说"把这个操作步骤标准化"
- 说"沉淀一下这个经验/流程"
- 粘贴操作描述并说"整理成文档/手册/标准格式"
- 上传口述转录/会议记录需要提炼SOP
关键词触发：
- "SOP"、"标准化流程"、"操作手册"、"新人指南"、"流程文档"
- "经验沉淀"、"外包交接"、"培训材料"、"工作流定义"
不触发（避免误激活）：
- 单纯聊天讨论某个话题（无整理文档的意图）
- 用户已有结构化SOP仅需排版美化（用文档工具更合适）
核心脚本
| 脚本 | 功能 | 核心命令 |
|---|
scripts/sop_extractor.py | 核心提取引擎 | python sop_extractor.py -f input.txt -o sop.json |
scripts/sop_optimizer.py | 优化分析器 | python sop_optimizer.py -i sop.json -o optimized.json --report report.json |
scripts/sop_formatter.py | 多格式输出 | python sop_formatter.py -i sop.json -f html -o sop.html |
scripts/report_generator.py | 可视化报告 | python report_generator.py -s sop.json --optimization report.json -o report.html |
能力边界说明
在开始处理之前，明确 Skill 的处理能力范围，避免用户期望落差：
✅ 擅长处理
- 线性操作流程：有明确先后顺序的步骤，如客服处理、内容发布、软件部署
- 个人/小团队 SOP：1-3人执行的操作规范，步骤数 ≤ 20
- 口语化描述：录音转录、聊天记录、随手记录的流程说明
- 已有文档的结构化提升：对质量参差不齐的旧文档做标准化升级
- 单一工具链流程：围绕1-2个主要系统/工具的操作流程
⚠️ 勉强处理（需降级期望）
- 极简描述（< 50字）：AI 会主动追问补充，但输出可能步骤偏少、细节不足
- 跨部门复杂协同：可提取主流程框架，但分支路径和例外情况需人工补充 → 推荐参考
references/collaboration_guide.md
- 高度技术性内容（如代码审查、数据库运维）：步骤可提取，技术细节需人工核实
- 非线性决策树流程：可用 Mermaid 流程图辅助表达，但结构化程度有限
❌ 不适合使用
- 纯聊天/无实质步骤内容：如"我们讨论了客服策略"，没有具体操作步骤
- 已是标准化 SOP 仅需排版：直接用文档工具更高效
- 需要精确技术规格的工程文档（如硬件操作规程、化学品处理手册）：此类需专业人工审核
- 超过 30 步骤的巨型流程：建议先拆分为子流程再分批处理
使用误区（5条反模式）
遇到这些情况时，换个思路效果更好：
| ❌ 常见误用 | ✅ 正确做法 |
|---|
| 把整个部门的全年工作流程一次性扔进来（100步+） | 先拆成 3-5 个子流程，分别提取后人工整合 |
| 用于整理聊天记录里的"讨论"而非"操作步骤" | 先从对话中提炼出具体操作动作，再输入 |
| 期望自动生成精确的技术规格（参数值、代码片段） | 用 Skill 提取步骤骨架，技术细节手工填充 |
| 只发一句"帮我整理销售流程"，不补充任何细节 | 参考快速开始的模板，粘贴具体操作描述 |
| 对已有格式规范的 Word/Excel SOP 做二次提取 | 此类直接在原文档修订即可，无需走提取流程 |
输入质量容错机制
输入质量直接影响输出效果，Skill 按以下策略自动降级处理：
| 输入质量 | 判断标准 | 处理策略 |
|---|
| 优质 | 有明确步骤、工具、检查点，≥ 100字 | 直接运行全流程，输出完整SOP |
| 一般 | 有基本步骤但细节不足，50-100字 | 先输出框架，标注「⚠️ 待补充」项，并追问关键缺失项 |
| 简短混乱 | < 50字 或 步骤逻辑混乱 | 不直接报错，改为追问3个关键问题，再处理 |
理解确认机制：收到复杂流程描述后，先输出一行确认：
📌 我理解你要整理的是「[流程名称]」，共识别到约 X 个步骤，覆盖[关键环节]。按[确认]继续，或告诉我理解有误的地方。
三轮追问话术（输入不足时）：
- 第1轮：「你的描述已收到，但缺少[前置条件/工具说明/结束标志]，能补充一下吗？」
- 第2轮：「好的，我已重新理解。请确认步骤顺序是否正确：[步骤列表]」
- 第3轮（仍不清晰时）：「能发一段具体的操作记录给我看看吗？哪怕是截图/笔记都可以」
错误诊断速查
当脚本输出错误时，对照下表快速定位并修复：
| 错误信息 | 原因 | 修复命令 |
|---|
No steps found | 输入无具体操作动词 | 补充描述后重试：python sop_extractor.py -f input.txt --min-steps 2 |
JSON decode error | 上一步输出文件损坏或为空 | 删除损坏文件重新运行：del sop_output.json && python sop_extractor.py ... |
FileNotFoundError: input.txt | 文件路径错误 | 用绝对路径：python sop_extractor.py -f "C:/full/path/input.txt" -o sop.json |
| HTML报告空白 | JSON路径含中文空格 | 将输出目录移至纯英文路径，如 C:/sop_output/ |
| HTML乱码 | 源文件非UTF-8编码 | 另存文件为UTF-8：notepad.exe → 另存为 → 编码选 UTF-8 |
| 步骤数过少 | 连词过多，未分行 | 加细粒度参数：python sop_extractor.py -f input.txt --granularity fine |
💡 更多排错详情见 references/faq.md
完整工作流
一键运行（推荐，新手首选）
cd ~/.workbuddy/skills/sop-extractor-plus/scripts/
python run_all.py -f input.txt -o output_dir/
run_all.py 自动串联全部步骤，最终在 output_dir/ 生成完整交付物。出错时自动输出「原因+修复建议」，无需手动排查。
分步运行（适合：进阶/调试用）
用户口述/转录文本
↓
sop_extractor.py → sop_output.json （提取结构化SOP）
↓
sop_optimizer.py → 优化分析 + 评分 （质量评估+改进建议）
↓
sop_formatter.py → 多格式文档输出 （HTML/MD/流程图/清单）
↓
report_generator.py → 可视化报告 （SVG图表+完整分析）
AI 工作流程
步骤 1：主动开场 + 收集原始描述
AI 应主动说明工作流程（触发后的开场话术）：
我来帮你把操作流程整理成标准SOP文档。我需要先了解一下你的流程，然后会帮你：
① 识别所有步骤和检查点 ② 评估文档质量（百分制） ③ 找出遗漏项 ④ 生成你需要的格式（HTML/流程图/清单等）
请把流程从头到尾描述一遍，越详细越好：
- 每一步用什么工具/系统？
- 中间哪个环节最容易出错？
- 最终怎么确认做完了/做对了？
对于简短或混乱的输入，启动三轮追问机制（见"输入质量容错机制"章节），不直接报错。
对于跨部门或多人协作场景，引导用户参考 references/collaboration_guide.md。
可参考 references/prompt_guide.md 的渐进式对话引导模板。
步骤 2：运行提取引擎（适合：标准用法）
cd ~/.workbuddy/skills/sop-extractor-plus/scripts/
python sop_extractor.py -f <用户提供的文本文件路径> -o sop_output.json
或使用 -t 直接传入文本。
步骤 3：运行优化分析（适合：标准用法）
python sop_optimizer.py -i sop_output.json -o sop_optimized.json --report optimization_report.json
步骤 4：生成交付物
根据用户需求选择格式：
python sop_formatter.py -i sop_optimized.json -f html -o sop.html --theme dark
python report_generator.py -s sop_output.json --optimization optimization_report.json -o sop_report.html
步骤 5：展示结果
打开 sop_report.html 或 sop.html 预览，向用户汇报：
- 提取的步骤数量和质量评分
- 发现的缺口和改进建议
- 生成的交付物清单
输出格式一览
| 格式 | 用途 | 命令参数 |
|---|
markdown | 文档归档、版本管理 | -f markdown |
html | 交互式Web页面（深色主题） | -f html --theme dark |
mermaid | 流程图嵌入 | -f mermaid |
checklist | 可打印执行清单 | -f checklist |
training | 新人培训卡片 | -f training |
json | 数据交换 | -f json |
all | 全部格式一键生成 | -f all -o output_dir/ |
质量评分体系
| 评分 | 等级 | 含义 |
|---|
| 85-100 | A | 优秀 — 可直接投入使用 |
| 70-84 | B | 良好 — 小修后即可发布 |
| 55-69 | C | 合格 — 需补充完善 |
| < 55 | D | 需改进 — 建议大幅完善 |
参考资料按需导航
| 你的情况 | 推荐阅读 |
|---|
| 第一次用，不知道输入什么 | references/examples.md → 查看真实案例 |
| 想了解质量评分如何计算 | references/quality_checklist.json |
| 需要对话引导用户提供详细描述 | references/prompt_guide.md |
| 遇到脚本报错/输出不理想 | references/faq.md |
| 需要套用特定行业模板 | references/sop_templates.json |
| 多人/跨部门协同场景 | references/collaboration_guide.md |
references/sop_templates.json — 8种行业SOP模板（客服/内容发布/软件部署/数据处理/招聘/采购/Bug修复/通用操作）references/quality_checklist.json — 7维度质量评估标准及常见缺失项references/prompt_guide.md — AI 渐进式对话引导模板（4轮对话脚本）references/examples.md — 4个完整使用案例（触发→处理过程→输出预览）references/faq.md — 12题常见问题解答（含脚本报错、简短输入、跨部门流程等边缘场景）references/collaboration_guide.md — 多人/跨部门协同SOP专项引导模板（含角色分工模板）
依赖
纯 Python 标准库，无需额外安装。所有脚本均为零依赖设计。
