SuperAPI AI 工具集

context-discovery

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:在开始不熟悉的模块或功能、任务涉及多个文件或系统、需要先理解现有模式再编码、或想避免重复已有功能时,使用该技能主动发现代码库上下文、既有模式、决策与相关工作,而不是只依赖 grep/read 循环。

主要能力与用法:

  1. 文件发现:用 fff 查找相关文件,如 fff auth、fff "order"、fff config,结果按 frecency 排序。
  2. 模式发现:用 sem 理解历史与结构,如 sem blame path/to/file.ts、sem diff main..HEAD -- path/、sem summary path/to/,提供实体级(函数级)差异。
  3. 历史上下文:用 ctx 搜索过往 agent 会话,如 ctx search "auth implementation patterns"、ctx search "this module" path/to/module/、ctx search "decision" "why did we" path/。
  4. 项目知识:用 qmd 查询持久项目知识,如 qmd query "What architecture decisions exist for X?"、qmd search "authentication patterns"、qmd get ADR-001。
  5. 代码结构:大型代码库用 codebase-memory-mcp 的代码图,如 search_graph("OrderHandler")、trace_path("OrderHandler", calls)、trace_path("OrderHandler", callers)、get_code_snippet("package.OrderHandler")、get_architecture()。
  6. 外部上下文:用 context7 查库与框架文档,如 context7 "express.js middleware API reference"。

决策参考:按名称/模式找文件用 fff;查近期变更用 sem diff;查过往 agent 讨论用 ctx search;查 ADR/项目记忆用 qmd query;理解代码结构用 codebase-memory;查外部文档用 context7;找相关 PR 用 github MCP。

适用场景:不熟悉的模块、多文件多系统任务、需要先理解模式再编码、可能涉及过往决策或讨论、想避免重复功能。

限制:简单任务或已熟悉的代码,grep + read 更快;外部 API 应改用 context7 或网络搜索;仅配置修改无需深度上下文。建议先广后窄,优先近期上下文,发现时间控制在 2-5 分钟,并将重要发现记录到实现日志或 qmd。