| name | searching-sops |
| description | Use when the user asks about past experiences, previous solutions, or historical decisions. Use when starting a task that may have been solved before. Use when the user mentions "before", "last time", "previously", or "how did we". Use when encountering auth, api, database, or domain-specific problems that may have historical SOP records. |
Searching SOPs
搜索 sop/ 目录下的历史 SOP 文档并从中学习。
核心原则
SOP 记录我们实际做了什么。 Skill 和 rule 告诉我们应该做什么。在解决新问题前，先检查是否解决过。
适用场景
- 用户问："之前我们是怎么处理 X 的？"
- 用户问："我们之前对 Y 的做法是什么？"
- 开始一个已有 SOP 记录的领域的任务（auth、api、database 等）
- 用户提到 "last time"、"before"、"previously"
- 存在多个可行方案，历史上下文有助于决策
不适用场景
- 用户询问通用最佳实践（使用 skill/rule 代替）
- 用户问 "how should I"（面向未来，不是历史）
- 项目中不存在
sop/ 目录
搜索流程
严格限定：只搜索 sop/ 目录。不要搜索 skills/、commands/、docs/ 或其他目录。
第一步：文件名搜索（最高优先级）
ls -lt sop/*<keyword>* 2>/dev/null
文件名匹配通常最相关。
第二步：内容搜索（补充）
rg -l -i <keyword> sop/ 2>/dev/null
内容搜索捕获关键词在正文中但不在文件名中的 SOP。
第三步：合并排序
- 合并第一步和第二步的结果
- 去重
- 按修改时间排序（
ls -lt）：新文件优先
第四步：读取学习
读取前 2-3 个最相关且最新的 SOP。提取：
- 背景：什么场景触发了这个 SOP？
- 伪代码步骤：解决方案的思路是什么？
- 关键决策：为什么选择这个方案？
应用学到的知识
读取 SOP 后：
- 向用户总结相关的历史经验
- 将学到的教训应用到当前任务
- 如果历史方案直接适用，明确说明
- 如果历史方案已过时或部分相关，解释差异
常见错误
| 错误 | 修复 |
|---|
| 搜索 skills/ 或 commands/ 而非 sop/ | 严格限定 sop/。其他目录包含通用指导，不是历史经验。 |
| 只检查文件名 | 始终同时做文件名和内容搜索 |
| 忽略文件时间 | 始终按 mtime 排序 — 更新的 SOP 代表更近的经验 |
| 用户问历史时推荐 skill | 用户问 "what did we do" → 搜索 SOP。用户问 "what should I do" → 使用 skill/rule。 |
