ki-search-first

项目记忆优先(口诀:遇事不决 ki-search):任何任务先查项目记忆,无结果或记忆不充分时再走专家团(expert-lookup)与解决方案(solution-lookup);已定位/已改代码时必查强关联。触发:任何任务开始前自动触发,或用户说"查记忆"、"改A要连带改B吗"。

SKILL.md

GitHub

项目记忆优先(遇事不决 ki-search)

概述

目的:让 AI 在处理任何任务前优先检索项目记忆,把"已沉淀的项目知识"作为第一信息源,避免重复排查、遗漏踩坑经验。

功能:前置 ki_search 检索项目记忆;命中则带着记忆求解;未命中降级到 expert-solution-workflow 复用路径;改代码时查询强关联关系。

使用场景:

  • 任何任务或问题开始处理前(自动触发,必做)
  • 已定位到要修改的代码、或代码已修改时(查询强关联关系)
  • 用户说"查记忆"、"先看看记忆里有什么"时

规则

AI 在遇到任何任务或问题、开始处理前,务必先使用 ki-search 查询项目记忆,作为第一优先级动作,先看记忆里有没有相关内容:

时机 动作 说明
任何任务/问题开始前 ki_search 查询项目记忆 必做,不跳过。口诀:遇事不决 ki-search
已定位到要修改的代码 / 已修改代码时 ki_search 查询被改模块的强关联关系 必做,见下方「修改代码时查询关联关系」小节
ki 记忆有相关内容 带着记忆结果求解 交叉参照后再动手
ki 记忆无结果/不充分 再走专家团 + 解决方案路径 详见 expert-solution-workflow

核心原则:

  • ki-search 永远最先:项目记忆是最高效、最贴近本项目的资产,先检索它,通常能直接命中答案或定位到关键代码位置。
  • 记忆未命中再降级:只有记忆无结果、或结果不足以支撑求解时,才进入 expert-lookup(业务模块专家团)/ solution-lookup(具体技术问题解决方案)复用链路。
  • 沉淀闭环:解决问题后,有价值的结论仍需按 expert-solution-workflow 沉淀到项目记忆,保证下次"遇事不决 ki-search"能命中。
  • 改代码先查关联:一旦已定位到要修改的代码(或已修改),必须查询被改模块的强关联关系,确认"改了这里牵动了哪些其他模块",避免遗漏跨模块契约/消费端造成连带破坏。

执行

查找流程(遇到任何任务/问题时)

1. 一律先 ki_search 查询项目记忆(必做,不分问题类型)
   ├─ 命中?→ 记下命中的记忆内容(关键代码位置 / 结论 / 踩坑)
   │        → 带着记忆去定位源码 / 直接求解
   └─ 未命中或结果不足以求解?
        → 进入 expert-solution-workflow 复用路径(use_skill("expert-solution-workflow"):
          判断类型 → 查专家/方案 → 查代码库)
2. 求解过程中如新产生关键知识,随时可再 ki_search 核对或补充检索
3. 解决后,按 expert-solution-workflow 沉淀流程把有价值结论写入项目记忆

检索要点:

  • 查询词用自然语言描述问题本质(如"订单超时怎么处理"、"登录模块在哪定义"),不要只搜单个单词。
  • 记忆结果与源码不一致时,以源码为准(项目记忆可能过期),但记忆仍是定位起点。
  • 命中结果不足以完全求解时,不要停在半路,继续走专家团/解决方案或查代码。

修改代码时查询关联关系

触发条件:当已经知道要修改的代码,或代码已修改时(含 code review、排错定位、重构、接口/数据结构变更等),必做此查询,不跳过。

动作:调用 use_skill("ki-memory-lookup"),检索被改模块的强关联关系(跨模块契约耦合 + 业务耦合),识别"改了这里牵动了哪些其他模块"。

为什么必做:强关联揭示"改数据源必须连带改消费端"这类不对称契约,代码中不直观、需浏览完整代码才能发现。提前查询可避免遗漏跨模块消费方/契约方,造成连带破坏(运行时错误)。

使用要点:

  • 改源端(生产方/数据源)→ 必须检查目标端(消费端/契约方)是否需连带修改
  • 改目标端(消费端)→ 通常源端不用改,不必误报
  • 查询失败 / 无可用记录 → 忽略继续,不阻塞主流程
  • 与 ki-memory-lookup 保持 SSOT,细节以该 skill 为准,本 skill 不重复

与 expert-solution-workflow 的关系

本 skill 是 expert-solution-workflow 的前置步骤,优先级更高:本 skill 负责「先 ki-search、记忆优先」,后续专家团/解决方案的查找与沉淀逻辑仍按 expert-solution-workflow 执行。两者职责互补,不冲突。

例外

以下情况可跳过 ki-search:

  • 用户明确说"不用查记忆"、"直接读代码"
  • 纯闲聊、寒暄、与任务无关的对话
  • 极平凡的一次性动作(如改一个单词/标点),且显然与项目记忆无关