AGENT SKILL

opst-business-search

检索 openspec/<领域>/<模块>/ 知识库中已归档的业务逻辑文档。支持关键词检索、领域浏览、精确模块查看三种模式。当用户提到"业务检索"、"搜索业务逻辑"、"business-search"、"查找模块"时使用此技能。

License 许可
MIT
所属仓库
fangkunx/skills
最近更新
2026-09-30
Stars
★ 0
Forks
0

01 前言 Front Matter

name
opst-business-search
license
MIT
metadata
{ "author": "fangkun", "version": "1.0", "generatedBy": "openspec-trace@1.0.0" }
description
检索 openspec/<领域>/<模块>/ 知识库中已归档的业务逻辑文档。支持关键词检索、领域浏览、精确模块查看三种模式。当用户提到"业务检索"、"搜索业务逻辑"、"business-search"、"查找模块"时使用此技能。
compatibility
Requires openspec CLI.

03 SKILL.md 正文

在 openspec/<领域>/<模块>/ 知识库中检索已归档的业务逻辑文档。

检索模式

模式 触发条件 示例
关键词检索 用户提供具体关键词 payment、销账、write-off
浏览模式 用户要求"列出所有"或"展示领域" 列出所有模块、展示领域
精确查看 用户指定具体模块或文档版本 查看 billing/payment-processing

工作流

步骤 1:解析查询

从用户输入提取关键词,判断检索模式:

  • 浏览模式:用户输入包含"列出"、"所有"、"展示领域"、"list"、"all" → 浏览模式
  • 精确查看:用户输入包含 领域/模块 路径格式(如 billing/payment-processing) → 精确查看
  • 关键词检索:其他情况 → 关键词检索

若用户未提供任何输入:使用 AskUserQuestion 询问检索关键词,并提供模式选项。

检查知识库是否存在:

若 openspec/openspec-trace/GLOBAL_INDEX.md 不存在,提示用户先执行 /opst:code-anysic 归档业务逻辑后再检索。

步骤 2:执行检索

关键词检索模式

  1. 读取全局索引:
    Read: openspec/openspec-trace/GLOBAL_INDEX.md
    
  2. 在"按关键词"表中匹配关键词列(精确匹配优先,模糊匹配补充)
  3. 在"按领域"表中匹配模块名称和领域名称
  4. 扫描各模块 INDEX.md 进行深度匹配:
    Glob: openspec/**/INDEX.md
    
    对每个 INDEX.md:
    Grep: <关键词> → openspec/<领域>/<模块>/INDEX.md
    
  5. 合并结果,按相关性排序(精确匹配 > 模块名匹配 > 内容匹配)

浏览模式

Read: openspec/openspec-trace/GLOBAL_INDEX.md

直接展示完整的按领域分类树。

精确查看模式

读取指定模块的索引文件:

Read: openspec/<领域>/<模块>/INDEX.md

若用户还指定了版本号(如 v1):

Glob: openspec/<领域>/<模块>/v1-*.md
Read: openspec/<领域>/<模块>/v1-<日期>.md

步骤 3:展示结果

关键词检索结果格式

检索关键词:"<关键词>"

找到 <N> 个匹配模块:

### <领域>/<模块>
  领域:<领域>
  入口:<入口类名>(<HTTP方法> <路径>)
  版本:v<N>(<日期>)
  关键词:<keyword1>, <keyword2>, ...
  摘要:<模块概述>

每个匹配模块后提供 AskUserQuestion 后续操作选项:

浏览模式结果格式

直接展示 GLOBAL_INDEX.md 内容,然后询问用户是否需要查看某个具体模块。

精确查看结果格式

展示 INDEX.md 完整内容,然后询问用户是否需要阅读具体版本的设计文档。

步骤 4(可选):JSON 输出

若用户要求 JSON 输出(提到 --json 或"以 JSON 输出"):

{
  "query": "<关键词>",
  "mode": "search | browse | exact",
  "results": [
    {
      "domain": "<领域>",
      "module": "<模块>",
      "index_path": "openspec/<领域>/<模块>/INDEX.md",
      "versions": [
        {
          "version": "<N>",
          "date": "<YYYY-MM-DD>",
          "change": "<变更名>",
          "doc_path": "openspec/<领域>/<模块>/v<N>-<日期>.md"
        }
      ],
      "keywords": ["<keyword1>", "<keyword2>"],
      "entry_points": [
        {
          "url": "<HTTP方法> <路径>",
          "method": "<方法名>()",
          "file": "<Controller文件名>:<行号>"
        }
      ],
      "summary": "<模块概述>"
    }
  ]
}

注意事项

  1. 知识库不存在时:若 openspec/openspec-trace/GLOBAL_INDEX.md 不存在,提示用户先执行 /opst:code-anysic 归档业务逻辑后再检索
  2. 无匹配结果时:展示现有所有领域树,提示用户尝试其他关键词
  3. 关键词模糊匹配:支持中英文混合匹配(如搜索 "sales" 可匹配中文描述中的"销账")
  4. 深度查看:查看设计文档时,如文档较长,优先展示接口定义和业务流程图章节
  5. 版本历史:展示模块时默认显示最新版本信息,用户可指定查看历史版本

04 同仓库更多 Skills