메뉴
SOP标准化流程提取器 — 将用户口述/转录的操作流程自动整理为标准SOP文档（含步骤、注意事项、所需工具、检查点），支持多维度质量评分、缺口分析、冗余检测、改进建议和多格式输出（Markdown/HTML/流程图/检查清单/培训卡片）。适用场景：经验沉淀、新人培训、流程标准化、外包交接、AI Agent 工作流定义。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/ZJU-REAL/HugAgentOS --skill sop-extractor명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
设计并创建一个子智能体，或改进一个已有的子智能体。当用户说"帮我建一个负责 X 的智能体"、"我想要个专门做 Y 的助手"、"把这套活儿交给一个专门的智能体"、"改一下我那个智能体的职责/能力/语气"、或问"这个智能体该怎么设计"时，务必使用本技能。它教你怎么切职责、怎么写 system_prompt、绑哪些能力、参数怎么定，然后通过 create_agent / edit_agent 工具落库。
从零攒一个插件包，或把一个 web 链接上的插件下载下来导入。当用户说"照着这个网页做个插件"、"把我这几个技能打包成插件"、"帮我做一个插件"、"这个链接的插件帮我装上"、或需要把一组配套的技能与工具打成可安装可卸载的整体时，务必使用本技能。它教你插件包的目录结构、plugin.json 怎么写、怎么自检、怎么通过 import_plugin 工具落库。
HugAgentOS 后端开发规范。当需要新增或修改后端代码（API路由、服务层、数据库模型、MCP工具等）时使用此 skill， 确保代码风格、分层架构、错误处理、响应格式等与项目现有规范保持一致。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | sop-extractor |
| description | SOP标准化流程提取器 — 将用户口述/转录的操作流程自动整理为标准SOP文档（含步骤、注意事项、所需工具、检查点），支持多维度质量评分、缺口分析、冗余检测、改进建议和多格式输出（Markdown/HTML/流程图/检查清单/培训卡片）。适用场景：经验沉淀、新人培训、流程标准化、外包交接、AI Agent 工作流定义。 |
| agent_created | true |
最快触发方式（直接复制粘贴给 AI）：
帮我把这个流程整理成SOP：[粘贴你的操作描述]
帮我沉淀一下[客服处理/内容发布/软件部署]的流程
我要给新人写一份[岗位名称]的操作手册，帮我整理成标准化文档
把下面这段操作记录结构化：[粘贴文字]
一句话版：把口述/文字描述扔给我，自动出SOP文档、质量评分、检查清单和流程图。
增值效果：平均节省 80% 的文档整理时间，步骤覆盖率从人工整理的 60% 提升至 90% 以上，自动发现 3-5 个常被遗漏的检查点。
将脑子里零散的操作经验一键转化为标准化SOP文档。用户只需口述流程（或上传转录文本），AI 自动完成：
当用户执行以下操作时自动加载：
明确触发（高置信度）：
关键词触发：
不触发（避免误激活）：
| 脚本 | 功能 | 核心命令 |
|---|---|---|
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 的处理能力范围，避免用户期望落差：
references/collaboration_guide.md遇到这些情况时，换个思路效果更好：
| ❌ 常见误用 | ✅ 正确做法 |
|---|---|
| 把整个部门的全年工作流程一次性扔进来（100步+） | 先拆成 3-5 个子流程，分别提取后人工整合 |
| 用于整理聊天记录里的"讨论"而非"操作步骤" | 先从对话中提炼出具体操作动作，再输入 |
| 期望自动生成精确的技术规格（参数值、代码片段） | 用 Skill 提取步骤骨架，技术细节手工填充 |
| 只发一句"帮我整理销售流程"，不补充任何细节 | 参考快速开始的模板，粘贴具体操作描述 |
| 对已有格式规范的 Word/Excel SOP 做二次提取 | 此类直接在原文档修订即可，无需走提取流程 |
输入质量直接影响输出效果，Skill 按以下策略自动降级处理：
| 输入质量 | 判断标准 | 处理策略 |
|---|---|---|
| 优质 | 有明确步骤、工具、检查点，≥ 100字 | 直接运行全流程，输出完整SOP |
| 一般 | 有基本步骤但细节不足，50-100字 | 先输出框架，标注「⚠️ 待补充」项，并追问关键缺失项 |
| 简短混乱 | < 50字 或 步骤逻辑混乱 | 不直接报错，改为追问3个关键问题，再处理 |
理解确认机制：收到复杂流程描述后，先输出一行确认：
📌 我理解你要整理的是「[流程名称]」，共识别到约 X 个步骤，覆盖[关键环节]。按[确认]继续，或告诉我理解有误的地方。
三轮追问话术（输入不足时）：
当脚本输出错误时，对照下表快速定位并修复：
| 错误信息 | 原因 | 修复命令 |
|---|---|---|
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 应主动说明工作流程（触发后的开场话术）：
我来帮你把操作流程整理成标准SOP文档。我需要先了解一下你的流程，然后会帮你：
① 识别所有步骤和检查点 ② 评估文档质量（百分制） ③ 找出遗漏项 ④ 生成你需要的格式（HTML/流程图/清单等）
请把流程从头到尾描述一遍，越详细越好：
- 每一步用什么工具/系统？
- 中间哪个环节最容易出错？
- 最终怎么确认做完了/做对了？
对于简短或混乱的输入，启动三轮追问机制（见"输入质量容错机制"章节），不直接报错。
对于跨部门或多人协作场景，引导用户参考 references/collaboration_guide.md。
可参考 references/prompt_guide.md 的渐进式对话引导模板。
cd ~/.workbuddy/skills/sop-extractor-plus/scripts/
python sop_extractor.py -f <用户提供的文本文件路径> -o sop_output.json
或使用 -t 直接传入文本。
python sop_optimizer.py -i sop_output.json -o sop_optimized.json --report optimization_report.json
根据用户需求选择格式：
# 交互式HTML（推荐首屏展示）
python sop_formatter.py -i sop_optimized.json -f html -o sop.html --theme dark
# 多人协作场景（适合：进阶）
# 参考 references/collaboration_guide.md 先拆分子流程，再分别格式化
# 综合可视化报告（适合：进阶）
python report_generator.py -s sop_output.json --optimization optimization_report.json -o sop_report.html
打开 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 标准库，无需额外安装。所有脚本均为零依赖设计。