Przejdź do treści
Biblioteka skilli
Nauka i badania · Research

cue-research-cli

/cue-research-cli

Opisuje obsługę CLI głębokich badań Cue (@cueai/cue-cli): wieloagentowe badania branż, firm, osób, polityk i zgodności, z raportem Markdown ze źródłami i dopytywaniem w sesji.

Repozytorium
cue-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Opisuje obsługę CLI głębokich badań Cue (@cueai/cue-cli): wieloagentowe badania branż, firm, osób, polityk i zgodności, z raportem Markdown ze źródłami i dopytywaniem w sesji.

Oryginalny opis (EN)

Cue 深度研究 CLI(@cueai/cue-cli,命令 cue)使用说明。用于行业/公司/人物/政策/合规类深度调研:一句话发起多智能体研究,输出带来源的 Markdown 报告,可落盘、可续接会话追问、可指定搭子模板。涉及「深度调研」「尽调」「行研」「公司研究」「竞品对比」「政策跟踪」「人物核查」等需要多源检索与交叉验证的场景时使用。

Jak działa

  1. 一、何时使用 / 何时不用
  2. 二、前置条件
  3. 三、命令速查
  4. 四、cue research 参数
  5. 五、推荐调用姿势
  6. 六、耗时与额度
  7. 七、错误处理
  8. 八、纪律
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 479 słów
Podgląd SKILL.md
---
name: cue-research-cli
description: Cue 深度研究 CLI(@cueai/cue-cli,命令 cue)使用说明。用于行业/公司/人物/政策/合规类深度调研:一句话发起多智能体研究,输出带来源的 Markdown 报告,可落盘、可续接会话追问、可指定搭子模板。涉及「深度调研」「尽调」「行研」「公司研究」「竞品对比」「政策跟踪」「人物核查」等需要多源检索与交叉验证的场景时使用。
version: "1.1.0"
---

# Cue 调研搭子(cue CLI)

`cue`(npm 包 `@cueai/cue-cli`)是 Cue(cuecue.cn)多智能体深度研究的本地命令行桥梁。WorkBuddy 负责安装与登录态调度,本 Skill 只负责「拿到命令后怎么调」。

**核心命令:`cue research`** —— 把一句自然语言问题交给 Cue,自动拆解子任务、多源检索交叉验证,返回带来源引用的 Markdown 研究报告。

> ⚠️ 本 skill 与仓库里那个**同名的 Python 形态** `cue-research/` 是两件事:那个是
> 让 agent 直接跑 Python 脚本的形态,本目录是 **CLI 形态**(命令 `cue`,由 WorkBuddy 安装)。
> 两者名字相近但入口不同,别混用。

## 一、何时使用 / 何时不用

**应使用**:需要多源检索 + 交叉验证 + 出报告的开放性问题,例如行业研究、公司/竞品调研、政策与监管跟踪、人物背景核查、合规风险体检、投前/贷前尽调。

**不应使用**:
- 单条事实查询(某股票现价、今天天气)—— 直接用行情/搜索工具,不要为它跑一次深度研究;
- 纯本地文件处理(解析 PDF、改写文档)—— Cue 不做这个(`cue` 没有文档解析命令);
- 需要秒级返回的交互 —— 一次研究通常数分钟。

## 二、前置条件

1. CLI 由 WorkBuddy 通过 `npm install -g @cueai/cue-cli` 安装(Node ≥ 20.12,由 WorkBuddy 托管运行时);
2. 登录态:`cue auth status`(Windows 为 `cue.cmd auth status`)输出「已登录」才算可用,退出码 0=已登录 / 2=未登录;
3. 未登录时引导用户在连接器面板点「连接」:`cue auth login` 会打印 https:// 授权 URL,由 WorkBuddy 打开浏览器完成设备码授权;
4. **浏览器授权暂不可用时的退路**:若 `cue auth login` 明确提示「服务端尚未开放设备码授权」,改用用户自填 Key —— 到 https://cuecue.cn/api-key 创建 key,然后 `cue auth login --api-key <key>`,或设 `export CUE_API_KEY=sk-...` 后重跑。**看到该提示时直接走这条退路,不要反复重试 `auth login`**;
5. 排障先看 `cue doctor`(输出 JSON:node 版本、配置文件、脱敏 key、API 连通性)。

> **登录态是怎么维持的**:设备码换来的访问令牌 1 小时过期,但 CLI 会在任何 API 调用
> 遇到 401 时**自动静默刷新一次并重试**。所以**不要因为一次 401 就急着让用户重新登录** ——
> 只有刷新也失败时,CLI 才会以退出码 2 结束,那时再引导重连。

## 三、命令速查

| 命令 | 用途 |
|---|---|
| `cue research "<问题>"` | 发起一次研究,报告打到 stdout(前台阻塞到完成) |
| `cue research "<问题>" -o <文件>` | 报告落盘为 Markdown,并附来源清单 |
| `cue research "<问题>" --json` | 输出 `{conversationId, elapsedMs, report, sources, timeline}` |
| `cue research "<问题>" --conversation-id <id>` | 续接同一会话追问 |
| `cue research "<问题>" --template-id <id>` | 用指定搭子模板跑 |
| `cue playbook list` / `cue playbook get <id>` | 查看搭子模板(列表 / 详情) |
| `cue doctor` | 环境与连通性自检(JSON,无副作用) |
| `cue auth login` / `status` / `logout` | 授权 / 查登录态 / 登出清凭证 |

Windows 下命令名用 `cue.cmd`,参数完全一致。

## 四、`cue research` 参数

| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| `<query>` | string | 是 | — | 研究问题,自然语言,用引号包裹 |
| `--template-id <id>` | string | 否 | — | 搭子模板;裸 id 自动补 `template_` 前缀,纯数字后缀直接报错 |
| `--conversation-id <id>` | string | 否 | 随机 | 续接会话;ID 来自上次输出的 `conversation_id` |
| `-o, --output <file>` | string | 否 | — | 落盘 Markdown,支持 `~/`,目录自动创建 |
| `--timeout <seconds>` | number | 否 | 1200 | 整轮超时 |
| `--json` | flag | 否 | false | 结构化输出,适合再做二次处理 |
| `-q, --quiet` | flag | 否 | false | 不打印进度(进度默认写 stderr) |

## 五、推荐调用姿势

**落盘(默认用法)**:

```bash
cue research "比亚迪 DM-i 与长城 Hi4 混动技术路线差异" -o reports/byd-hi4.md
```

**要结构化结果**(需同时拿到来源与时间线):加 `--json`。

**续接追问**:用上次输出的 `conversation_id` 加 `--conversation-id`,在原研究上下文里追问(如「再补一节供应商集中度」)。

**用搭子模板**:先 `cue playbook list` 找到 `template_id`,再 `--template-id` 传入。

## 六、耗时与额度

- 单次研究通常数分钟,默认超时 1200 秒;
- 一次只跑一个研究,不要并发;
- 深度研究消耗 Cue 额度,问题越聚焦越省;不要为验证连通性反复提交真实研究(用 `cue doctor` 验证连通即可)。

## 七、错误处理

| 退出码 | 含义 | 处理 |
|---|---|---|
| 0 | 成功 | — |
| 2 | 缺少/失效凭证(含 401、403) | 重新连接;`cue auth login` |
| 3 | 入参错误(如纯数字 template_id) | 改参数后重试 |
| 4 | 网络不可达 | 检查网络/代理/`--base-url` |
| 5 | 超时 | 加大 `--timeout`,或用 `--conversation-id` 续跑 |
| 1 | 其他错误 | 读 stderr 原文 |

「未捕获到报告正文」时 stderr 会给出 `kind=...`(`no_agent_events` / `stream_cut_before_reporter` / `reporter_started_no_text`)与 `conversation_id`,据此续跑或调超时,不要凭空补写内容。

## 八、纪律

- 不在命令行、日志或回复里输出 API Key;非必要不用 `--api-key`(会进进程列表);
- 报告结论以 Cue 返回的正文与来源为准,缺失部分标注「未检索到」,**不要补写未经验证的数据**;
- 需要用户决策的高风险动作(对外发送、下单、删除)先确认;研究本身只读取公开信息与用户自有数据。

Wersje

W bazie nie ma innych skilli o nazwie cue-research-cli.

Migawka bazy z 13.11.2026 · wersja paczki 24123f7f463d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100cue-research
    Uruchamia w Cue pytanie badawcze na zapisanym szablonie Buddy albo jako swobodne głębokie badanie, wyłącznie na danych publicznych, i pozwala zapisać wynik jako szablon.
  • 100cue-agent-profile-manager
    Pomaga zarządzać profilami Claude Code lub Codex, skillami, serwerami MCP i konfiguracją agenta za pomocą poleceń cue CLI.
  • 100cue-buddy
    Pomaga tworzyć, walidować, debugować, testować i strojić szablon badawczy Cue Buddy dla powtarzalnych scenariuszy, takich jak wstępna weryfikacja kredytowa czy przegląd wyników, wyłącznie na danych publicznych.
  • 100your-cue
    Zestawia w jedno podsumowanie stan wszystkich działających sesji agentów: kto czeka na użytkownika i co skończyło się w nocy.
  • 90cue-library-workflow
    Naprawia kodowanie i brakujące nazwy utworów w plikach CUE, weryfikując je z okładką, notatkami i oficjalnymi listami utworów.
  • 100audio-brief-to-cue-sheet
    Zamienia brief audio na sygnały, czasy, ścieżki i wymagania dostawy.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.