opst-business-search

Files (1)

• SKILL.md

SKILL.md (first lines)

在 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** 后续操作选项：
- 查看完整 INDEX.md
- 查看 CHANGELOG.md（版本历史）
- 阅读指定版本的设计文档

#### 浏览模式结果格式

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

#### 精确查看结果格式

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

### 步骤 4（可选）：JSON 输出

若用户要求 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"
        }
      ],

From fangkunx/skills, MIT.

More from fangkunx/skills