seer-api-explorer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Seer API Explorer

Read seer-shared for response format and common rules.

Use this skill when the user's need is not covered by existing Seer skills. Before using this skill, check if

seer-market

already has the command you need.

请阅读 seer-shared 了解响应格式和通用规则。

当用户的需求未被现有Seer skill覆盖时使用本skill。使用本skill之前，请检查

seer-market

是否已经存在你需要的命令。

When to Use

使用场景

User asks about a command you don't recognize
User needs data that existing skills don't document
You want to discover what commands are available
You need to understand a command's exact input/output contract

用户询问你不认识的命令
用户需要现有skill未记录的数据
你想要查找可用的命令列表
你需要了解某个命令确切的输入/输出约定

Discovery Flow

探索流程

Step 1: Check existing skills first

步骤1：优先检查现有skill

If the user's question maps to a known command in

seer-market

, use that skill directly. Only proceed here if it doesn't.

如果用户的问题可以匹配到

seer-market

中的已知命令，直接使用对应skill即可，仅当无匹配项时再执行后续步骤。

Step 2: List all commands

步骤2：列出所有命令

bash

seer-q schema

Returns every registered command with its description, arguments, and flags. Use this to find the right command for the user's need.

bash

seer-q schema

返回所有已注册命令，包含其描述、参数和标志位，你可以通过该命令找到满足用户需求的合适命令。

Step 3: Inspect a specific command

步骤3：查询特定命令详情

bash

seer-q schema <command>

Returns the full contract for one command: positional arguments, flags with defaults, and response shape description. Use this to understand exactly what to pass and what to expect.

bash

seer-q schema <command>

返回单个命令的完整约定：位置参数、带默认值的标志位，以及响应结构描述，你可以通过该命令准确了解需要传入的参数和预期返回结果。

Step 4: Call with raw output

步骤4：调用并返回原始输出

bash

seer-q <command> [args] [flags] --raw

The

--raw

flag bypasses the envelope and returns the API response directly. This is useful for:

Inspecting the full response structure when the envelope obscures it
Debugging unexpected output
Exploring fields not documented in skills

bash

seer-q <command> [args] [flags] --raw

--raw

标志位会跳过封装结构，直接返回API响应，适用于以下场景：

当封装结构遮蔽内容时，查看完整响应结构
调试非预期输出
探索skill中未记录的字段

Step 5: Interpret and synthesize

步骤5：解读与整合内容

After receiving the response:

Parse the JSON (remember:
```
.data
```
contains the payload if not using
```
--raw
```
)
Identify the relevant fields for the user's question
Synthesize into natural language
Include any
```
view_url
```
found in the response

收到响应后：

解析JSON（注意：如果未使用
```
--raw
```
，载荷内容存放在
```
.data
```
中）
定位与用户问题相关的字段
整合为自然语言回答
包含响应中找到的所有
```
view_url
```

Example

示例

User: "what stages does Seer use for processing?"

Not covered by seer-market → use API explorer
```
seer-q schema decisions
```
→ discover
```
--stage
```
flag and its allowed values
```
seer-q decisions --limit 5
```
→ see real stage names in output
Summarize the processing stages found

用户："Seer的处理流程包含哪些阶段？"

seer-market未覆盖该需求 → 使用API探索器
执行
```
seer-q schema decisions
```
→ 发现
```
--stage
```
标志位及其允许取值
执行
```
seer-q decisions --limit 5
```
→ 在输出中查看真实的阶段名称
总结找到的处理阶段