用途
nav-sop 用于把一次性的经验转化为团队可复用的标准操作流程（SOP）。当用户说出“document this solution”“save this for next time”“create SOP”“make this reusable”，或解决新问题后提到“不想再踩这个坑”、完成集成后要求“记录配置步骤”、建立模式后说“团队应该照这个做”时触发。它适合记录第三方服务集成、常见问题修复、开发工作流与部署流程。
不使用时的情况：创建任务文档应使用 nav-task 技能；更新架构文档属于另一目的；没有可复用模式的简单 bug 修复也不建议创建 SOP。
主要能力
- 按类别归档：integrations（第三方服务配置）、debugging（常见问题与解决方案）、development（开发流程与模式）、deployment（部署步骤与 CI/CD）。
- 生成结构化文档：包含 Context（适用场景、解决的问题、前置条件）、The Problem（症状、错误信息、根因）、The Solution（分步操作、命令与代码、原因说明、预期输出）、Complete Example（完整可运行代码）、Testing（验证命令与预期结果）、Prevention（预防策略与警告信号）、Troubleshooting（常见故障与修复）、Related Documentation（关联任务与外部文档）、Maintenance Notes（更新时机、负责人、测试版本）。
- 查重与命名：检查目标类别下是否已有相似 SOP，提供读取、更新或新建三个选项；名称统一转为小写连字符格式，未提供名称时按 {service}-{action} 生成。
- 保存与索引：写入 .agent/sops/{category}/{name}.md，并在 .agent/DEVELOPMENT-README.md 的 SOP 索引中登记一行描述。
- 双向链接：若 SOP 源自某个任务，则在任务文档与 SOP 中互相引用，便于发现。
使用方式
调用技能后，依次确定类别、确定名称、检查重复、生成内容、保存文件、更新索引、按需关联任务，最后输出完成信息（标题、类别、路径、大小、包含的章节及索引更新状态）。若 .agent/sops/ 目录不存在，会提示“Navigator not initialized”，需先运行 /nav:init 创建目录结构；类别目录缺失时自动创建。同名 SOP 冲突时同样提供读取、更新、改名（如 -v2）三种选择。
适用场景
修复棘手的 CORS 或 JWT 问题后记录根因与预防措施；完成 Stripe、GitHub OAuth、SendGrid 等集成后固化配置与测试流程；团队约定受保护路由的测试方式；整理生产部署与回滚步骤。
限制
资料未提供该技能的收费、平台支持范围、性能指标或与其他技能的集成细节；实际可用性取决于 Navigator 是否已初始化及项目目录结构。SOP 质量依赖对话中提供的真实解决过程，技能本身不验证代码正确性。