create-sop（AI代理标准操作程序创建Skill）Skill 是什么？

AI代理标准操作程序创建Skill：把口头经验变成 AI 能照着执行的说明书

一句话定位：这是一个「SOP 生成引导器」，通过 /create-sop 命令，带着你把模糊的工作流程梳理成结构统一、带验证步骤、可直接交给 AI 代理执行的标准操作程序文件。
核心机制：不是简单套模板，而是先问清目的与使用时机，再判定 SOP 类型（分析、实现、部署、维护），最后按固定结构落盘为 .sop.md 文件。
差异化价值：内置 RFC 2119 关键词规范（MUST / SHOULD / MAY / MUST NOT / SHOULD NOT）与 kebab-case 命名约定，让「文档」真正具备被 Agent 严格执行的约束力。
上手成本：低。一条斜杠命令即可启动，全程对话式引导，默认保存到 ~/sops/ 目录，也可按类别分目录管理。
最适合谁：需要把部署、审查、重构、运维等重复流程沉淀为可复用资产的研发团队、技术负责人和 AI 工作流搭建者。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

基本信息

项目	内容
技能中文名	AI代理标准操作程序创建Skill
技能英文名	create-sop
技能 ID	14077
调用方式	斜杠命令 `/create-sop`，完整标识为 `agent-sop:create-sop`
产出物	一个结构化的标准操作程序文件（`.sop.md`）

它解决什么问题

团队里的「隐性经验」通常以三种形态流失：老员工脑子里的步骤、聊天记录里零散的注意事项、以及只写了一半的 Wiki 页面。这些内容人可以勉强读懂，但 AI 代理读不懂——缺少前置条件、缺少验证点、缺少「什么绝对不能做」的硬约束。

create-sop 的作用就是把这类经验结构化：它通过逐步询问确定 SOP 的目的（处理什么工作流、何时使用、预期结果是什么），识别 SOP 类型，然后按统一骨架生成文件，并对关键约束强制使用 RFC 2119 关键词标注严重程度。这样产出的文件既能给人当操作手册，也能直接喂给 AI 代理执行。

一键安装思路与步骤

准备前提：确认你使用的 AI 客户端/代理环境支持「技能（Skill）」机制与斜杠命令；如果打算让 Agent 直接读取 SOP 执行，还需要具备与 Agent SOP MCP 服务器配合的条件。具体支持范围请以官方说明为准。
获取技能：在技能市场、技能仓库或官方技能目录中检索技能 ID 14077 或英文名 create-sop，选择安装到当前工作环境。若你的环境提供技能管理入口，通常支持通过技能名一键添加；具体命令与入口地址请以官方说明为准。
确认落位：安装后确认技能已在当前会话或项目的可用技能列表中可见，且命令标识为 agent-sop:create-sop。
验证是否生效：新开一个会话，输入 /create-sop。若技能正常生效，应当立即进入引导流程——先询问你这个 SOP 要处理什么工作流，而不是直接丢给你一个空模板或返回「命令不存在」。
做一次最小闭环验证：用一个小流程（例如「每周依赖更新检查」）完整走一遍生成流程，检查产出文件是否包含概述、参数、先决条件、步骤、成功标准、错误处理、相关 SOP 七个板块，以及是否以 .sop.md 结尾。

2. 该技能的主要功能和特点

目的澄清式引导：若用户未说明用途，技能会主动追问三件事——该 SOP 处理什么工作流或任务、应当在何时使用、预期结果是什么。这一步避免了「为了写文档而写文档」。
自动判定 SOP 类型：把流程归入四类之一——分析/审查类（分析代码、审查 PR、审计）、实现类（构建功能、编写代码、修改代码）、部署类（部署变更、回滚、配置）、维护类（更新依赖、清理、重构）。类型决定后续步骤的颗粒度。
固定七段式结构模板：输出统一为「行动动词 + 具体结果」的标题，加上概述、参数、先决条件（必需工具/必需知识/必需设置）、步骤（含验证点）、成功标准（可勾选清单）、错误处理（症状/原因/解决方案）、相关 SOPs。
强制 RFC 2119 关键词分级：MUST 用于安全与数据完整性等绝对要求，MUST NOT 用于绝对禁止，SHOULD / SHOULD NOT 表达强烈推荐与强烈不鼓励，MAY 标注可选增强。这就是让 AI 代理「知道哪条不能碰」的关键。
命名与归档规范：文件名使用 kebab-case 与 .sop.md 扩展名，例如 deploy-production.sop.md、code-review-security.sop.md；保存位置支持自定义，默认 ~/sops/，并建议按 deployment/、development/ 等类别分目录。
步骤内建验证：每个主要步骤后都要求写「验证」——如何确认这一步真的成功了，而不是靠感觉认为成功了。
交付后动作清单：创建完成后提示你逐步走查测试、加入 SOP 索引（如存在）、确保扩展名为 .sop.md 以便与 Agent SOP MCP 服务器配合，并在 SOP 会持续演进时加入版本号与变更日志。

和普通工具比强在哪：通用文档工具给你一张白纸，通用大模型给你一段「看起来像文档」的文字；而 create-sop 给的是带约束等级、带验证点、带错误分支的可执行规范——它是「面向 Agent 的文档格式」，而不只是「给人看的文档」。

3. 如何使用该技能？

方式一：对话式创建（最常用）

在支持该技能的会话中输入 /create-sop。
回答技能的第一轮追问：这个 SOP 处理什么工作流、何时使用、期望结果。示例回答：「用于把服务部署到生产环境，每次发版前使用，期望结果是零停机上线且可一键回滚。」
确认技能判定的类型（此处为部署类）。若判定不符，直接说明你的真实场景，技能会据此调整步骤结构。
跟随引导逐项补齐内容：必需工具（如 kubectl、docker 及版本要求）、必需知识（如了解滚动更新策略）、必需设置（如集群访问凭证配置）。
编写步骤：技能会提示你以行动动词开头、在关键操作后补验证点。示例步骤可以是「执行干运行部署」「验证新版本 Pod 状态为就绪」「切换流量并验证健康检查通过」。
标注约束等级：把「必须先备份数据库」标为 MUST，「建议在低峰期执行」标为 SHOULD，「可开启详细日志」标为 MAY。
填写成功标准清单与常见错误处理（例如「镜像拉取失败」的症状、原因、三步解决方案）。
指定保存位置与文件名，例如 ~/sops/deployment/deploy-production.sop.md。
按技能给出的后续建议走查一遍 SOP，必要时补版本号与变更日志。

方式二：从需求一句话直接启动

输入「帮我创建一个用于部署到生产的 SOP」，技能会先问澄清问题、识别必需工具（如 kubectl、docker 等）、规划步骤、生成带 RFC 2119 关键词的结构化文件、保存到合适位置，并建议用干运行部署来测试这份 SOP。

输入与输出示例

输入：/create-sop 帮我写一个安全代码审查的 SOP
输出：一个 code-review-security.sop.md 文件，其中含「参数」区（如审查范围、严重级别阈值）、「先决条件」区（工具与权限）、编号步骤及每步验证、成功标准勾选清单、以及「遗漏密钥扫描」等错误场景的处理方案。

使用建议：不要一次写完就完事。技能本身建议「通过逐步走查测试 SOP」——把自己当成执行者，照着文件走一遍，凡是卡住的地方就是文档需要补充验证点或错误处理的地方。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
create-sop（本技能）	面向 AI 代理的 SOP 生成引导器	目的澄清、类型判定、七段式模板、RFC 2119 关键词、`.sop.md` 命名规范、MCP 兼容	低，需支持技能与斜杠命令的环境，一条 `/create-sop` 启动	部署、审查、实现、维护类流程沉淀；Agent 工作流标准化	优势：结构统一、约束可分级、对话式引导不易漏项；不足：产出仍需人工走查验证，非全自动
手工 Markdown 模板 / 团队 Wiki	通用文档协作	自由编辑、协作评论、版本历史	低，但需要自建模板与规范	轻量流程说明、内部知识库	优势：灵活、易共享；不足：格式不统一、无约束等级、AI 代理难以稳定解析执行
通用大模型直接写文档	通用文本生成	一次性生成长文档	低，提示词即可	快速起草、文案润色	优势：灵活快速；不足：结构随机、缺少验证点与错误分支、约束强度不可控、需反复返工
工作流编排/自动化平台	可执行流程引擎	可视化编排、定时触发、失败重试	中高，需学习平台概念并配置环境	已确定的高频自动化任务	优势：真正可执行、可观测；不足：写之前仍要想清楚流程，且不产出人机共读的规范文档

选型建议：如果你要的是「一份人和 AI 都能照着做的规范」，选 create-sop；如果你要的是「机器自动跑起来」，编排平台更合适——两者可以串起来用，先用本技能把流程写清楚，再据此配置自动化。

5. 该技能的典型应用场景与实际体验情况

场景一：后端团队的生产部署规范

角色：负责发版的后端工程师。痛点：部署步骤散落在多个聊天记录里，新人发版常漏掉回滚预案。使用方式：/create-sop 后描述部署流程，把「部署前必须完成数据库备份」标为 MUST，「建议低峰期发布」标为 SHOULD，并在每步后补验证点。体验：引导问题会逼着你把「什么算部署成功」说清楚，这是最容易漏的一环；注意干运行测试不可省，SOP 写完不等于验证过。

场景二：安全代码审查与 PR 审计

角色：技术负责人或安全评审者。痛点：审查标准因人而异，AI 代理审查时尺度飘忽。使用方式：创建分析/审查类 SOP，把强制项（如「MUST 检查密钥硬编码」）与推荐项（「SHOULD 检查依赖版本」）分开标注。体验：RFC 2119 分级是这类场景的最大增益——Agent 能区分「必须拦下」和「建议提醒」；注意成功标准要写成可衡量项，避免「代码质量良好」这类模糊表述。

场景三：新人上手与维护类流程

角色：团队新人或轮值维护者。痛点：依赖更新、清理、重构这类周期性工作没有书面依据。使用方式：创建维护类 SOP，把版本要求、环境配置写进先决条件，把常见报错整理进错误处理区。体验：上手难度低，跟着问答走即可完成；建议按类别存入 ~/sops/maintenance/，并加版本号与变更日志，方便后续演进。

场景四：AI 工作流与 MCP 集成

角色：搭建 Agent 工具链的工程师。痛点：自研 Agent 读不懂自由格式文档。使用方式：用本技能生成 .sop.md 文件，确保扩展名与命名规范，再配合 Agent SOP MCP 服务器使用。体验：格式一致性直接决定解析成功率；注意保存位置要选在 Agent 有权访问的目录，否则会出现「文件写了但读不到」。

6. 该技能能为用户带来的价值

把经验变成资产：每次 /create-sop 的产出都是可复用、可版本化的文件，而不是一次性对话。团队的流程知识从「人走即失」变成「文件常在」。
显著降低文档返工：七段式结构与澄清式提问，把「写完发现漏掉先决条件和错误处理」的概率压到很低，一次成型比例远高于自由写作。
让 AI 代理真正可托付：RFC 2119 关键词给出了明确的行为边界，MUST NOT 项等于给 Agent 画了红线，降低了自动化执行中的安全与数据风险。
降低协作门槛：统一的命名（kebab-case + .sop.md）与目录约定，让团队检索、复用、评审都有据可依；新成员无需口头交接即可照着执行。
长期价值：SOP 会随业务演进，配合版本号与变更日志，形成一份可追溯的流程演进史，也让 Agent 的行为变更可审计。

7. 常见问题 FAQ

Q1：怎么安装这个技能？具体命令是什么？

在支持技能机制的环境里，通过技能市场或技能目录检索技能 ID 14077 或英文名 create-sop 进行添加。由于不同客户端入口不同，具体安装命令与操作路径请以官方说明为准。安装完成后输入 /create-sop，若进入引导提问即表示生效。

Q2：这个技能收费吗？

技能详情中未包含任何定价信息，是否收费取决于你使用的技能分发平台与订阅方案，请以官方说明为准。

Q3：适合谁用？我只写文档不做 AI 代理，有必要用吗？

两类人都适合。做 AI 代理/自动化的人需要它来产出机器可执行的规范；纯人类团队也能受益——澄清式提问和验证点设计本身就提升了文档质量。

Q4：和直接让大模型写 SOP 有什么区别？

直接让大模型写，结构随机且约束强度不可控。本技能强制七段式结构、强制标注 RFC 2119 关键词、强制在步骤后补验证点，并遵循 .sop.md 命名规范，产出稳定性与可执行性明显更高。

Q5：生成的 SOP 文件保存在哪里？能改吗？

技能会询问保存位置，默认使用 ~/sops/，并建议按 deployment/、development/ 等类别建子目录。若要与 Agent SOP MCP 服务器配合使用，务必保留 .sop.md 扩展名。