SuperAPI AI 工具集

create-sop

办公与效率

查看项目

更新于 10-16 06:56

技能介绍

用途

create-sop 用于帮助用户为 AI 智能体创建结构良好的标准操作程序(SOP)文件。它通过交互式引导,协助确定 SOP 的目的、组织内容、应用 RFC 2119 关键词,并以正确的命名约定保存文件。

主要能力

  • 询问并明确 SOP 的用途:涉及的工作流或任务、使用时机、预期结果。
  • 确定 SOP 类型:分析/审查类(分析代码、审查 PR、审计)、实现类(构建功能、编写代码、进行变更)、部署类(部署变更、回滚、配置)、维护类(更新依赖、清理、重构)。
  • 按固定结构生成 SOP 文件,包含以下章节:
    • 标题:以动作动词开头并描述具体结果。
    • Overview:1-2 句话说明该 SOP 完成什么以及何时使用。
    • Parameters:列出参数名、参数标识、描述与示例值,以及配置选项。
    • Prerequisites:必需工具(含版本要求)、必需知识、必需环境配置。
    • Steps:分步操作,包含子步骤、实现细节、预期结果,以及每步的验证方法。
    • Success Criteria:可衡量的结果清单,如测试通过、文档更新等。
    • Error Handling:常见错误的症状、原因和解决步骤。
    • Related SOPs:关联 SOP 及其使用时机或后续操作。
  • 指导正确使用 RFC 2119 关键词:MUST(绝对要求)、SHOULD(强烈建议)、MAY(可选操作)、MUST NOT(绝对禁止)、SHOULD NOT(强烈不推荐)。
  • 文件命名:使用 kebab-case 和 .sop.md 扩展名,例如 deploy-production.sop.md、code-review-security.sop.md。
  • 保存位置:询问保存路径,默认建议 ~/sops/,并可按类别组织,如 ~/sops/deployment/、~/sops/development/。

使用方式

该命令以 /create-sop 形式调用。执行后,它会引导用户完成以下流程:

  1. 询问 SOP 目的(若未提供):涉及什么工作流或任务、何时使用、预期结果是什么。
  2. 确定 SOP 类型(分析/审查、实现、部署、维护)。
  3. 按上述结构创建 SOP 文件。
  4. 适当使用 RFC 2119 关键词。
  5. 按命名约定保存文件,并询问保存位置。

创建完成后,建议:

  • 通过走查测试该 SOP。
  • 如果存在 SOP 索引,将其加入索引。
  • 若与 Agent SOP MCP 服务器配合使用,确保文件具有 .sop.md 扩展名。
  • 考虑版本管理(若 SOP 会演进,添加版本和变更日志)。

适用场景

  • 为 AI 智能体编写可复用的操作流程文档。
  • 需要标准化分析、实现、部署或维护类任务的执行步骤。
  • 希望以结构化方式记录前置条件、验证方法和错误处理。

限制

资料中未提供关于收费、价格、平台支持范围或具体效果的信息。该命令的具体实现细节、依赖环境及兼容性暂未提供。