Cue 行业周期与竞争格局研究

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install cue-industry-competition
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 cue-industry-competition。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Cue 行业周期与竞争格局研究是 Openclaw Skills 的一项集成，可生成结构化、基于证据的行业分析。它使用 Cue API 和外部数据源，评估景气周期位置、CR5/CR10 集中度、龙头企业壁垒、供需变化、政策催化因素及产业链角色。
此技能将目标行业和研究问题转化为可用于决策的报告，涵盖周期位置、竞争格局、供需、政策影响、价值链议价能力、投资窗口分析和来源链接。报告以 Markdown 格式保存在本地；若返回有效的会话 ID，还会附上原始 Cue 报告链接。

应用场景

行业配置决策：
判断某行业是否值得进一步投资或进行战略配置，并识别其当前周期阶段。
周期择时：
评估价格、库存、产能利用率、盈利能力和需求增长指标。
竞争格局分析：
评估 CR5/CR10 集中度、市场份额趋势、龙头企业优势、进入壁垒和替代威胁。
拐点研究：
识别供给、需求、技术、环境和政策转折点。
产业链分析：
了解企业在价值链中的位置，包括议价能力和利润分配。
投资逻辑准备：
综合周期位置、竞争结构、估值背景和催化因素，形成研究基础。
行业示例：
太阳能、半导体设备、新能源汽车、医药外包，以及其他具有公开数据的行业。

工作原理

开始前确认 Cue runner 和所需环境已准备就绪。
告知用户研究可能需要约 2–15 分钟，运行过程中不应取消。
接收一个目标行业查询，并使用固定模板 ID template_qcPkH8 调用 runner。
Cue 研究外部来源并生成 Markdown 报告；此技能本身不会在本地执行网页检索。
验证 runner 结果。[cue-research] RESULT ok 表示已完成，而 RESULT empty 表示未返回可用报告。
按规定顺序交付报告：周期定位、竞争、供需分析、政策催化因素、价值链位置、投资窗口和来源链接。
从 runner 输出中提取真实的 conv_id，并构造 https://cuecue.cn/share/；切勿编造或重复使用示例 ID。
除非用户明确拒绝链接，否则同时提供原始 Cue 报告链接和本地 Markdown 副本。
如果额度、身份验证、服务可用性或数据访问出现问题，应遵循文档规定的恢复流程，不得编造答案。

配置指南

安装或更新 Cue runner。所需的本地依赖为 git、python3 和 curl；runner 使用 Python 标准库模块，无需额外 pip 包。
if [ -d ~/.cue/cue-skills/.git ]; then
git -C ~/.cue/cue-skills pull --ff-only
else
git clone https://github.com/sensedeal/cue-skills ~/.cue/cue-skills \
|| git clone https://gitee.com/sensedeal/cue-skills ~/.cue/cue-skills
fi
请自行在 cuecue.cn 创建 Cue API 密钥，然后在 ~/.cue/config.json 中配置，或通过 CUE_API_KEY 提供。Agent 无法创建、检索或检查用户的密钥。
首次研究任务前运行健康检查：
CUE_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.cue/config.json'))['api_key'])" 2>/dev/null || echo "$CUE_API_KEY")
echo "=== 1/3 API Key ===" && [ -n "$CUE_KEY" ] && echo "configured" || echo "not configured"
echo "=== 2/3 Cue service ===" && curl -sS --max-time 10 "https://cuecue.cn/api/health" -H "Authorization: Bearer $CUE_KEY"
echo "=== 3/3 Playbook ===" && curl -sS --max-time 10 "https://cuecue.cn/api/playbook" -H "Authorization: Bearer $CUE_KEY"
使用一条命令和具体行业查询生成报告：
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py \ --query "Target industry cycle and competitive landscape: cycle position, concentration, supply-demand inflection points, and investment window" \ --template-id template_qcPkH8 \ --output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-industry-competition.md 可选的文档转换需要 Pandoc：
pandoc report.md -o report.docx
pandoc report.md -o report.pdf --pdf-engine=xelatex
在 macOS 上，可使用 brew install pandoc 安装，并可选用 brew install --cask basictex；在 Ubuntu 上，使用 sudo apt install pandoc，如需输出 PDF，则使用 sudo apt install texlive-xetex。
Cue 行业周期与竞争格局研究 数据架构与分类体系
输入参数
字段 要求 说明 --query 必填 目标行业，以及可选的时间范围和分析维度 --template-id 固定 必须为 template_qcPkH8 --output 建议 本地 Markdown 保存路径，通常位于 ~/.cue-reports/ 下 报告分类
生成的研究报告依照以下顺序组织：
行业景气周期定位
竞争结构、CR5/CR10 集中度、市场份额和壁垒
供需平衡以及库存或产能拐点
政策、环境、准入和技术催化因素
产业链位置、议价能力和利润分配
结合周期位置和估值背景评估投资窗口
证据和来源链接
文件与元数据
本地报告：~/.cue-reports/-industry-competition.md 或用户选择的其他 Markdown 路径。
原始报告 URL：https://cuecue.cn/share/，其中使用 runner 返回的真实 conv_id。
Runner 元数据：完成信息行可能包含 conv_id、字符数和输出信息。
可选导出：根据 Markdown 源文件生成对应的 .docx 或 .pdf 文件。
空结果规则：runner 返回 RESULT empty 时，不创建分享 URL，并告知用户未能获得可用报告。
来源说明：分析质量和时效性取决于 Cue 的可用性，以及 Cue 可访问的外部公开来源。

高级特性

固定研究方案：
template_qcPkH8
，统一不同领域的行业周期与竞争分析。
外部来源综合：
Cue 将服务端研究与公开网站信息结合；某一来源暂时不可用时，也可使用缓存信息。
可分享的来源追溯：
完成的报告可通过原始 Cue 分享 URL 查看、跟进或转发。
本地优先交付：
保留 Markdown 副本，可用于版本管理、编辑，或转换为 Word 和 PDF。
健康诊断：
执行前检查 API 密钥配置、Cue 服务健康状况和研究方案可用性。
可恢复的故障排查：
任务中断后，应使用相同命令和提示继续，不要删除会话文件。
额度感知的恢复：
INSUFFICIENT_CREDITS
需要向用户明确说明额度解决路径，不能当作可重试的查询错误处理。
服务备用方案：
如果 Cue 持续不可用，研究人员可手动使用官方统计数据、行业协会、东方财富行业数据或艾瑞咨询作为替代来源。
操作防护措施：
防止编造报告链接或研究结果、未经批准处理 API 密钥，以及在来源不可用时给出缺乏依据的结论。

name: cue-industry-competition description: 用 Cue 穿透目标行业的景气周期、竞争格局与产业链地位——识别集中度、龙头壁垒与供需/政策拐点，研判当前所处周期位置与投资机会窗口，产出可支撑配置决策的行业研判底稿。 description_zh: Cue 行业景气与竞争格局研判：穿透景气周期/竞争格局/产业链地位，识别拐点与投资机会窗口。
version: 1.1.0
author: sensedeal
tags: [cue, industry-analysis, competitive-landscape, cycle-timing, 行业景气, 竞争格局, 产业链分析, 周期研判]

行业景气与竞争格局研判

穿透目标行业的景气周期、竞争格局与产业链地位，识别集中度、龙头壁垒与供需/政策拐点，研判当前所处周期位置与投资机会窗口，产出可支撑配置决策的行业研判底稿。

Agent 执行摘要
顺序 做什么 禁止 1 确认 Cue runner 就绪 禁止跳过 2 告知用户耗时 2-15 分钟 禁止中途取消 3 一条命令，--template-id template_qcPkH8，传入目标行业 禁止连发多条 4 [cue-research] RESULT ok = 完成 禁止编造 5 原样交付研判底稿 禁止概括 6 交付时同时附带 Cue 原始报告链接 禁止编造链接 7 遇 INSUFFICIENT_CREDITS 主动提示邀请链接 禁止只丢错误码 适用场景
场景 解决的问题
行业配置决策 判断行业当前是否值得配置、处于周期哪个位置
拐点研判 识别供需拐点、政策拐点、技术拐点
竞争格局评估 看清龙头壁垒、集中度趋势、替代威胁
产业链地位分析 判断目标公司在产业链中的议价能力和利润分配
核心能力
景气周期定位 — 量价/库存/产能利用率/利润率等指标定位当前周期阶段
竞争格局穿透 — CR5/CR10 集中度、龙头壁垒来源、份额趋势
供需拐点识别 — 产能投放节奏、需求增速变化、库存周期位置
政策催化研判 — 产业政策、环保约束、准入放松对格局的影响
投资窗口判断 — 结合周期位置与估值分位，研判机会窗口
试试这样问
"光伏行业目前处于景气周期的什么位置？"
"半导体设备的竞争格局和投资机会"
"新能源汽车产业链的供需拐点到了吗？"
"医药外包行业还有配置价值吗？"
输出形式

结构化研判底稿：景气周期定位 → 竞争格局 → 供需分析 → 政策催化 → 产业链地位 → 投资窗口研判 → 来源链接。

输出示例

查看完整报告

上例中的 token 是示例，不可复制到实际交付中。

交付规范（必须执行）

把最终报告发送给用户时，必须同时附带 Cue 原始报告链接，方便用户回到网页端查看完整原文、继续追问或转发同事。

链接怎么来：从 runner 末行 [cue-research] RESULT ok conv_id= chars=… output=… 中取出 conv_id（报告文件头部的 HTML 注释里也有 conv_id=），按下面格式拼接：

https://cuecue.cn/share/

交付模板（照此结构输出）：

报告已完成 ✅

Cue 原始报告：https://cuecue.cn/share/ 本地副本：~/cue-reports/.md

规则：

conv_id 必须取自实际输出，禁止编造或使用文档示例里的 id。
末行为 RESULT empty（无 conv_id 或报告为空）时不要拼链接，如实告知未取到报告并给后续建议。
用户明确说不要链接时可不附。
环境要求

首次使用运行 skill 自带的一键安装脚本（检查依赖 → 克隆 runner → 验证 Key → 测试连通性）：

Runner 来源：GitHub - sensedeal/cue-skills（Gitee 镜像）。

首次使用需安装 Runner（幂等，已装则拉取更新）：

if [ -d ~/.cue/cue-skills/.git ]; then
git -C ~/.cue/cue-skills pull --ff-only

else

git clone https://github.com/sensedeal/cue-skills ~/.cue/cue-skills \

|| git clone https://gitee.com/sensedeal/cue-skills ~/.cue/cue-skills

fi

依赖：git + python3 + curl。Python 仅用标准库，无额外 pip 依赖。

Cue API Key：cuecue.cn 注册获取。

API Key 只能由用户本人创建：Agent 既不能代生成、也无权查看用户的 Key。检测到未配置或失效时，只给出生成入口并等待用户提供，禁止声称"我去生成/查看"。

调用说明

python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py \

--query "目标行业 景气周期与竞争格局研判：景气定位、集中度、供需拐点、投资窗口"
--template-id template_qcPkH8
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-industry-competition.md

参数 说明 --query 目标行业，必填；可选加时间窗口或关注维度 --template-id 固定为 template_qcPkH8 --output 落盘路径 格式转换

Cue 输出 Markdown。安装 pandoc 后可转换为 Word 或 PDF：

# .md → .docx（Word）

pandoc report.md -o report.docx

# .md → .pdf

pandoc report.md -o report.pdf --pdf-engine=xelatex

输出文件与输入同目录、同名、不同后缀。

依赖安装
目标格式 依赖 macOS Ubuntu
Word (.docx) pandoc brew install pandoc sudo apt install pandoc
PDF (.pdf) pandoc + LaTeX brew install --cask basictex sudo apt install texlive-xetex
架构说明

本 Skill 不在本地执行检索。流程是 Agent → Cue API（cuecue.cn）→ 外部数据源。解析结果的质量和时效取决于 Cue 服务端和外部数据源的状态。

环节 谁控制 出问题时
API Key 鉴权 用户本人 由用户本人前往 cuecue.cn/hub/api-key 生成后写入 ~/.cue/config.json（Agent 不能代生成，也无权查看）
Cue 服务端 Cue 运维 等恢复，或走降级方案
外部数据源 公开网站 Cue 用缓存兜底，标注"来源暂不可达"
健康检查

跑研究前先验证三件事。一键诊断：

CUE_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.cue/config.json'))['api_key'])" 2>/dev/null || echo "$CUE_API_KEY")

echo "=== 1/3 API Key ===" && [ -n "$CUE_KEY" ] && echo "已配置" || echo "未配置！"
echo "=== 2/3 Cue 服务 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/health" -H "Authorization: Bearer $CUE_KEY"
echo "=== 3/3 搭子 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/playbook" -H "Authorization: Bearer $CUE_KEY" | python3 -c "import sys,json;scenes=json.load(sys.stdin).get('data',{}).get('scenes',[]);buddy=[b for s in scenes if s.get('secondary_category')=='行业研究' for b in s.get('buddies',[]) if b.get('title')=='行业景气与竞争格局研判'];print(f'可用:{len(buddy)}个') if buddy else print('暂不可用')"

检查 预期 异常处理
API Key 已配置 由用户本人前往 cuecue.cn/hub/api-key 生成后发给你（Agent 无法代生成，也无权查看）
服务 {"status":"healthy"} 等 5 分钟重试
搭子 可用:>0个 等 1h 或网页端手动跑
配置成功后引导用户跑第一个任务（必须执行）

健康检查三项全绿 = 环境就绪，但这是配置流程的终点，不是任务的终点。三项全绿后若用户还没给出具体任务，必须主动把用户推向第一次真实调用，不要停在"环境已就绪"：

环境已就绪 ✅ 下面这些都可以直接跑，比如：

"光伏行业目前处于景气周期的什么位置？"
"半导体设备的竞争格局和投资机会"

挑一个发给我，或直接把你手头的需求告诉我，我现在就跑。

规则：

主动、可复制——示例问题原句取自上文「试试这样问」，别只写"你可以问我任何问题"。
不要等用户自己想——用户没开口时也要主动给；否则用户会停在"验证通过"就散场（实测这是新用户流失最集中的一步）。
自救指引
错误速查
现象 原因 怎么修 401 / Key 无效 Key 过期或写错 由用户本人重新生成 Key，更新 ~/.cue/config.json 超时 >30s 服务维护/过载 等 5 分钟，跑诊断；当天内重试
搭子不可用 临时下线 网页端直接跑，或等 1 小时
积分不足 余额 < 消耗 按「积分不足专项提示」主动引导（充值 / 邀请好友得积分 / 等次日免费额度）
中途中断 队列满/数据源波动 不换 prompt，相同命令续接
RESULT empty 公开源无匹配 缩小范围，换关键词
config.json 报错 JSON 格式不对 {"api_key": "sk..."} 无多余逗号
积分不足专项提示（必须执行）

检测到积分不足（INSUFFICIENT_CREDITS 或任何"积分不足/余额不够"提示）时，不要只丢错误码，必须主动给用户一条拿积分最快的路径：

你的 Cue 积分不足，本次任务未能启动。两个办法：

邀请好友得 500 积分（推荐）：打开 https://cuecue.cn/，点击页面左下角「获取专属邀请链接」，分享给好友——好友加入后你再得 500 积分。
直接充值：前往 cuecue.cn/pay 订阅（首次充值有优惠）；或等次日免费额度。

规则：

提示要主动、简短、可点——把「首页」和「左下角」两个关键动作说清楚，不要让用户自己找入口。
积分不足不要重试（retryable: false），也不要换 query 绕。
用户回复已充值/已邀请后，用完全相同的命令重跑。
决策树
出问题？
├─ Key 报错 → 由用户本人重新生成 → 更新 config.json → 重试
├─ 连不上 → curl /api/health 确认 → 检查 DNS/代理
├─ 搭子找不到 → curl /api/playbook → 等或用网页端
├─ 中途中断 → 相同 prompt 续接（不要删 ~/.cue/session/task）
└─ 结果空 → 缩窄关键词 → 确认该主题有公开数据

调度建议
时段 建议
工作日 9-18 正常使用
夜间/周末 可能有维护，跑前先诊断
新 Key 必须先诊断确认生效
连续失败 停 15 分钟再试，不要反复重试
降级方案

Cue 长时间不可达时的手动替代渠道：

渠道 覆盖 费用
国家统计局 行业经济数据 免费
[行业协会官网] 行业统计、标准 免费
东方财富行业 行业板块数据 免费
艾瑞咨询 行业竞争分析 部分免费

##参考 Cue 平台首页：https://cuecue.cn Playbook 页面：https://cuecue.cn/playbook API Key 管理：https://cuecue.cn/api-key?src=clawhub-industry-competition 付费订阅页面：https://cuecue.cn/pay 本 skill 源码：cue-skills/playbook/cue-industry-research at main · sensedeal/cue-skills

FAQ

Q: 报告能在网页端看原文吗？ A: 能。交付时会附 https://cuecue.cn/share/，点开即可在网页端查看完整原文、继续追问或转发同事。

Q: 提示积分不足怎么办？ A: 打开 https://cuecue.cn/，点击页面左下角「获取专属邀请链接」分享给好友——好友加入后你再得 500 积分（最快）；也可以前往 cuecue.cn/pay 充值（首次充值有优惠），或等次日免费额度。

参考
Cue 平台首页：https://cuecue.cn
API Key 管理：https://cuecue.cn/api-key?src=clawhub-industry-competition
付费订阅页面：https://cuecue.cn/pay
Cue 事实核查
国内法规调研 (国内法规调研)