nav-sop 是 supernavigator 中的一项技能,用于在解决新问题、完成集成或确立工作模式后,创建可复用的标准操作流程(SOP)文档。它与 /nav:doc sop 命令功能相同,但支持自然语言调用。
用途:当用户说“记录这个解决方案”“保存下来下次用”“创建 SOP”“让团队遵循这个模式”时触发,把个人经验转成团队文档。不适用于创建任务文档、更新架构文档或无复用价值的简单修复。
主要能力:按 integrations、debugging、development、deployment 四类归档;生成包含问题背景、症状、根因、分步解决方案、代码示例、测试、预防措施和故障排查的 SOP;检查是否已有相似 SOP 并提供重复处理选择;更新 Navigator 索引,并与相关任务文档交叉链接。
使用方式:依次确定分类、确定名称(小写加连字符,如 stripe-payment-setup)、检查是否已存在(ls .agent/sops/{category}/*.md 2>/dev/null)、生成内容并写入 .agent/sops/{category}/{name}.md、更新 .agent/DEVELOPMENT-README.md 索引、按需关联任务、输出确认信息。若目录缺失会创建分类目录;若 .agent 结构不存在则提示运行 /nav:init。
适用场景:修复棘手 bug 后记录、完成第三方服务集成后记录、确立团队统一模式、复杂工作流文档化。
限制:需要已初始化的 .agent 目录结构;不负责任务文档和架构文档;一次性且不可复用的问题不建议记录;官方未提供收费、平台或效果方面的信息,暂未提供。