前言¶
团队里常见的情况是：老员工凭经验操作，新人只能反复问；流程散落在聊天记录或脑子里，培训材料迟迟写不出来。自己从零搭 SOP 模板、补步骤编号、异常处理和变更记录，往往要占掉不少时间。
下面介绍 SkillHub 上的 SOP生成器（@user_70c2f807/sop-generator-pro）。它在 Agent 里按固定工作流引导你提供流程输入，再输出结构化的标准作业流程文档，适合配合 Cursor、Claude Code 等支持 Skills 的客户端使用。
这是什么¶
SOP生成器 是基于通用 SKILL.md 格式的 Agent Skill，坐标为 @user_70c2f807/sop-generator-pro，当前版本 1.0.0，来源为 community，SkillHub 分类为 business-ops，发布者为 user_70c2f807。页面标注 requires_api_key=false，安装后无需额外 API Key。
Skill 的定位是：将口述或文字描述的流程转化为结构化 SOP，包含步骤、截图位置标注说明、注意事项和常见问题，面向「新人培训缺标准、知识难以沉淀」一类文档化需求。官方说明中明确 不适用于 代码编写、项目管理、培训课程设计等场景。
核心功能¶
以下能力均来自该 Skill 包内的 SKILL.md 说明：
- 触发场景：用户提到 SOP、标准作业流程、操作手册、流程文档，或要求创建 SOP、记录工作流时启用。
- 输入方式：依赖用户口述操作步骤，或提供录屏对应的文字描述；不能直接分析视频文件，也不能在无流程信息时凭空编造步骤。
- 结构化输出：将非结构化描述转为标准 SOP，包括自动编号、预估耗时、决策点与分支、前置条件、所需工具、预期结果、异常处理表、FAQ、变更记录等。
- 多形态文档：支持详细版、快速版、检查清单版；可按用户要求精简或补充 FAQ。
- 辅助能力：可生成 Mermaid 流程图代码，便于在飞书、Notion 等环境渲染；对描述过简、流程遗漏、术语难懂等情况会按 Skill 内置话术追问或提醒。
- 质量原则：强调步骤零歧义、每步可验证、新人可读、易错点标注，以及版本可维护。
生成结果需由用户或业务专业人员审核，Skill 声明 不验证流程准确性；医疗、化工等特殊行业需用户自行补充专业细节。
安装与启用¶
安装流程以 SkillHub 官方文档 skillhub.md 为准。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能无法被识别。本 Skill 的 CLI 安装形式为：
skillhub install sop-generator-pro --namespace user_70c2f807 --dir <你的 skills 目录>
也可让 AI 按官方页面提示，依据 skillhub.md 安装 @user_70c2f807/sop-generator-pro。
3、各客户端 skills 目录（节选）¶
官方文档给出的常见路径如下，请按你实际使用的客户端选择：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装到正确目录后，按你所用客户端的要求刷新或重启 Agent，使 Skill 被加载。
典型用法¶
Skill 内置的对话示例可作为复现路径参考。先做需求确认，再逐步补充流程，最后生成文档。
确认主题与读者
用户：帮我写一个SOP
→ Agent 会询问：流程主题是什么？目标读者是谁（新人/外包/全员）？
给出流程名称并口述步骤
用户：新员工入职开通系统权限的流程
→ Agent 会请用户按步骤描述操作细节。
用户：[口述完整流程]
→ 输出结构化 SOP，含步骤、注意事项、异常处理。
迭代文档
用户：再加一个常见问题部分
→ 基于流程补充 FAQ。
用户：帮我简化一下，太长了
→ 精简为快速版，保留核心步骤。
输出模板在 Skill 中规定了文档编号、前置条件、分步操作（含预计耗时与预期结果）、异常处理表、变更记录等章节，Agent 会按该模板组织内容。
适用场景与注意¶
适合谁
- 运营、IT、客服、内训等需要把「会做的事」写成可交接文档的团队。
- 已在用 Cursor、Claude Code 等 Skills 能力、希望用对话完成 SOP 初稿的场景。
限制与坑
| 情况 | 说明 |
|---|---|
| 无流程输入 | 不能只给标题就期望生成完整 SOP，必须提供步骤描述或转写文本。 |
| 视频素材 | 不能直接分析视频，需先文字化。 |
| 自动化执行 | SOP 是文档，不是可自动执行的脚本。 |
| 高合规行业 | 安全生产等需资质的场景，Skill 建议由专业人员编写，不宜单独依赖生成结果。 |
| 隐私 | Skill 声明不存储用户流程信息；文档中应对密码、IP 等敏感信息脱敏。 |
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 972 次，安装计数 0（页面字段，可能与本地实际安装不同）。
结尾¶
SOP生成器 把「口述 → 结构化标准作业文档」拆成可重复的 Agent 工作流，并内置模板、追问与多版本输出，适合作为 SOP 初稿与知识沉淀的起点；上线前仍须人工走一遍流程并审核。
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/sop-generator-pro
API 坐标页：https://api.skillhub.cn/user_70c2f807/sop-generator-pro
