gangtise-copilot

Gangtise Copilot

一键安装器、凭证配置器和诊断层，适用于完整的 Gangtise（岗底斯投研）OpenAPI 技能套件。

---

🚀 一键安装（完整流程）

这是从零开始到 Gangtise 完全可用唯一需要阅读的部分。请按顺序完成以下步骤。

Step 1 — 将此技能下载到 Agent 的技能目录

首选方法（git clone）：

git clone --depth 1 https://github.com/daymade/claude-code-skills.git /tmp/gangtise-repo
cp -r /tmp/gangtise-repo/daymade-financial/gangtise-copilot <your-agent-skills-dir>/

备用方法（git clone 超时或不可用时，直接使用 GitHub API）：

# Python one-liner to download and write any file from GitHub:
import urllib.request, json, base64, os
def fetch_github_file(repo_path, local_path):
    url = f"https://api.github.com/repos/daymade/claude-code-skills/contents/{repo_path}"
    req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
    d = json.loads(urllib.request.urlopen(req, timeout=20).read())
    content = base64.b64decode(d["content"]).decode("utf-8")
    os.makedirs(os.path.dirname(local_path), exist_ok=True)
    open(local_path, "w").write(content)
    return len(content)

# Download all files:
for path, local in [
    ("daymade-financial/gangtise-copilot/SKILL.md",                         "<skills-dir>/gangtise-copilot/SKILL.md"),
    ("daymade-financial/gangtise-copilot/scripts/install_gangtise.sh",      "<skills-dir>/gangtise-copilot/scripts/install_gangtise.sh"),
    ("daymade-financial/gangtise-copilot/scripts/configure_auth.sh",        "<skills-dir>/gangtise-copilot/scripts/configure_auth.sh"),
    ("daymade-financial/gangtise-copilot/scripts/diagnose.sh",              "<skills-dir>/gangtise-copilot/scripts/diagnose.sh"),
    ("daymade-financial/gangtise-copilot/scripts/classify_response.py",     "<skills-dir>/gangtise-copilot/scripts/classify_response.py"),
    ("daymade-financial/gangtise-copilot/references/installation_flow.md",   "<skills-dir>/gangtise-copilot/references/installation_flow.md"),
    ("daymade-financial/gangtise-copilot/references/credentials_setup.md",    "<skills-dir>/gangtise-copilot/references/credentials_setup.md"),
    ("daymade-financial/gangtise-copilot/references/skill_registry.md",       "<skills-dir>/gangtise-copilot/references/skill_registry.md"),
    ("daymade-financial/gangtise-copilot/references/known_issues.md",         "<skills-dir>/gangtise-copilot/references/known_issues.md"),
    ("daymade-financial/gangtise-copilot/references/best_practices.md",       "<skills-dir>/gangtise-copilot/references/best_practices.md"),
    ("daymade-financial/gangtise-copilot/config-template/authorization.json.example", "<skills-dir>/gangtise-copilot/config-template/authorization.json.example"),
]:
    size = fetch_github_file(path, local)
    print(f"OK {path} → {local} ({size} bytes)")

重要：连接 GitHub 的网络可能不稳定。如果任何文件下载失败，请针对该文件重试，最多 3 次，每次间隔 2 秒。不要因为单个文件下载失败而中止整个流程。

Step 2 — 在 Agent 中注册此技能

对于 OpenClaw：在 Agent 的技能目录中创建符号链接，并在网关配置中启用它：

# Find the OpenClaw skills directory
ls ~/workspace/agent/skills/     # or ls ~/.openclaw/skills/

# Symlink this skill
ln -sf <gangtise-copilot-source-dir> <openclaw-skills-dir>/gangtise-copilot

# Enable in OpenClaw gateway config (if the agent supports skill entries in config)
# Run: openclaw config set 'skills.entries.gangtise-copilot' '{}'
# Then restart the gateway using OpenClaw's own script, not this skill's:
# sh <openclaw-install-dir>/scripts/restart.sh

Step 3 — 安装全部 19 个 Gangtise 官方技能

bash <gangtise-copilot-dir>/scripts/install_gangtise.sh --preset full

作用：从官方 Huawei Cloud OBS 存储桶下载 4 个 ZIP 包，解压出 19 个技能目录，并将它们链接到检测到的 Agent 技能目录中（~/.openclaw/skills/、~/.claude/skills/ 等）。

已知的 Agent 技能目录路径（如果自动检测未找到你的目录）：

Agent	技能目录
Claude Code	~/.claude/skills/
Codex	~/.agents/skills/
OpenClaw	~/.openclaw/skills/ 或 <agent-workspace>/skills/

如果安装失败，请查看 references/installation_flow.md。

Step 4 — 配置凭证

bash <gangtise-copilot-dir>/scripts/configure_auth.sh \
  --access-key <your-accessKey> \
  --secret-key <your-secretAccessKey>

作用：

1. 写入 ~/.config/gangtise/authorization.json（权限模式 600）
2. 执行实时身份验证调用，以确认凭证有效
3. 写入 ~/.GTS_AUTHORIZATION 运行时令牌
4. 创建符号链接，将每个已安装技能自身的 <gangtise-skill-dir>/scripts/.authorization 链接到共享凭证文件

⚠️ 关键提示：完成 Step 3 后，即使凭证已存在，diagnose.sh 也可能报告“19 skill(s) missing .authorization”。即使 ~/.config/gangtise/authorization.json 已存在，也请运行 Step 4——configure_auth.sh 会创建缺失的符号链接。

Step 5 — 验证安装

bash <gangtise-copilot-dir>/scripts/diagnose.sh

预期输出：不应有 ❌ 行。通过检查的确切数量取决于安装了哪些 Agent 和预设。OAuth 检查成功只能证明凭证可以生成令牌；RAG 行会单独报告服务是否可访问、成功但结果为空、权限被拒绝、身份验证被拒绝，或返回配额／权益响应。

如果仍有任何 ❌ 或 ⚠️，请对照 references/known_issues.md 排查。

Step 6 — 使用真实查询进行测试

# Example: query latest research report for 宁德时代
# Use gangtise-file-client with its report runner:
cd <gangtise-copilot-dir>/references/
# See skill_registry.md for the exact command per skill

---

概览

Gangtise 是一个中国专业投资研究数据平台。它发布了一个 OpenAPI，涵盖研究报告、公司公告、会议摘要、首席分析师观点、财务报表、估值指标、OHLC 市场数据、股东数据、行业指标，以及预构建研究工作流技能目录。底层 API 设计完善，但技能生态难以发现：没有公开清单列出这 19 个技能；这些技能以独立 ZIP 文件的形式存放在一个禁止列出内容的华为云 OBS 存储桶中；技能还采用两套并行命名规范（精简版为 gangtise-<name>，完整功能版为 gangtise-<name>-client），两者提供的功能集不同。首次使用的用户必须先逆向梳理完整的技能清单，才能安装。

Gangtise Copilot 通过一条命令解决这个问题：

1. 通过单次打包下载并分发流程，将全部 19 个 Gangtise 官方技能安装到 Claude Code、OpenClaw 和 Codex。
2. 引导用户设置 accessKey + secretAccessKey，并通过对 open.gangtise.com/application/auth/oauth/open/loginV2 发起实时身份验证调用来验证。
3. 提供只读诊断脚本，报告已安装的技能、有效凭据以及可访问的功能层级。
4. 提供预设安装模式（minimal / workshop / full），让用户根据账户许可实际允许的范围选择安装规模——有关为何“安装最大规模”并非安全的默认选项，请参阅 references/known_issues.md 中的 ISSUE-007。

2026 年 4 月使用提示：安装技能后，即使 ~/.config/gangtise/authorization.json 已存在，也要运行 configure_auth.sh。上游 CLI 脚本还会读取 ~/.GTS_AUTHORIZATION，这是一个纯运行时令牌文件。配置程序会刷新这两个文件。

架构原则（不得违反）

此技能是 Gangtise OpenAPI 技能套件的封装层。封装层契约不可妥协：

• 绝不内置上游文件。 此技能目录不包含任何 Gangtise 技能内容的副本、分叉版本或摘录。Gangtise 发布新版本时，用户无需受到此封装层的任何干扰，即可获取新版本——安装程序每次运行都会从规范 OBS URL 重新下载。
• 如需修复，应在运行时进行，而非随产品发布。 此封装层源自一次未遇到任何实际上游错误的使用过程——遇到的障碍是技能难以发现和安装流程编排，而非文件损坏。若未来出现上游错误，应将其添加到 references/known_issues.md，并提供运行时修复说明，而不是在发布时打补丁。
• 修改上游文件前，务必先征求同意。 修改任何已安装的 gangtise-* 技能目录，都必须通过 AskUserQuestion 明确征得用户同意。
• 重在指导，不要隐藏。 每个安装步骤都会向用户明确展示下载了哪些技能、从哪里下载，以及凭据文件保存在哪里。这样用户才能学会自行维护安装内容。

此技能的功能

功能	入口	详情
1. 安装 Gangtise 技能（默认精简版、workshop 别名、完整版本或自定义 --only）	scripts/install_gangtise.sh	请参阅 references/installation_flow.md
2. 配置 accessKey + secretAccessKey 凭据	scripts/configure_auth.sh	请参阅 references/credentials_setup.md
3. 诊断安装状态、凭据有效性和功能层级	scripts/diagnose.sh	请参阅 references/known_issues.md
4. 查询哪个 Gangtise 技能可以回答特定数据问题	下方的技能注册表 + references/skill_registry.md	—

路由

触发此技能时，请判断用户意图并跳转到相应功能：

用户可能会这样说……	前往
"装 gangtise"、"install gangtise"、"我想用 gangtise 的数据"、"把 gangtise 的 skill 都装上"	一键安装（以上步骤 1–5）
"配 gangtise 的 key"、"configure gangtise credentials"、"gangtise accessKey"、"secretAccessKey"	功能 2
"gangtise 报错"、"token is invalid"、"接口地址错误"、"gangtise skill 加载失败"、"我的 gangtise 装得不对"	功能 3
"宁德时代的研报"、"过去 30 天的首席观点"、"OHLC 蜡烛图"、"个股研究报告 L2"、"对宁德时代做观点 PK"	功能 4 → 技能注册表 → 调用匹配的上游技能
"帮我从头跑一遍 gangtise"	一键安装（按顺序执行步骤 1–5）

如无法确定，请先使用 功能 3（diagnose.sh）——这是唯一的只读入口，可明确显示当前受阻的安装和凭据。运行它绝不会产生破坏性副作用。

功能 1：安装 Gangtise 技能

Gangtise 在华为云 OBS 存储桶中发布了 19 个独立技能。这些技能分为 3 个套件 ZIP 和 1 个独立 ZIP。安装程序会下载这 4 个压缩包，解压出 19 个技能目录，并将每个目录符号链接到检测到的 Agent 的技能目录中。

分发源

所有技能均来自 Gangtise 官方 OBS 存储桶：

https://gts-download.obs.myhuaweicloud.com/skills/

没有镜像源。安装程序会直接使用此 URL。

套件映射

套件	大小	包含内容
gangtise-skills-client.zip	160 KB	data-client、kb-client、file-client、file-client-no-download、stockpool-client
gangtise-research.zip	220 KB	stock-research、opinion-pk、thematic-research、stock-selector、event-review、interview-outline、announcement-digest、opinion-summarizer、wechat-summary、data-processor
gangtise-skills.zip	118 KB	data（v1.2.0）、file、kb——旧版“精简”并行系列
gangtise-web-client.zip	8 KB	web-client（独立版本，不属于任何套件）

总计：4 次 HTTP 请求 → 19 个技能目录。

两个技能（gangtise-file-client-no-download 和 gangtise-stockpool-client）仅存在于 gangtise-skills-client 套件中——它们没有独立 ZIP。简单地“为每个技能列出独立 ZIP”的做法会完全漏掉它们。完整说明请参阅 references/known_issues.md 中的 ISSUE-002。

一条命令安装

bash scripts/install_gangtise.sh

标志：

bash scripts/install_gangtise.sh --preset minimal    # default — 3 skills via public open-* endpoints
bash scripts/install_gangtise.sh --preset workshop   # alias for minimal (same 3 skills)
bash scripts/install_gangtise.sh --preset full       # all 19 skills (most -client will fail without skills-backend ACL)
bash scripts/install_gangtise.sh --only data-client,kb-client,file-client  # custom subset
bash scripts/install_gangtise.sh --no-openclaw       # skip OpenClaw even if detected
bash scripts/install_gangtise.sh --target claude-code  # force single target

预设内容

预设	技能	适用对象
minimal（默认）	gangtise-data、gangtise-file、gangtise-kb	为可访问公开 open-* 端点的账户提供保守的安装方案。它避开了 ISSUE-007 中的 skills-backend/* ACL，但 API 点数和产品权限仍然适用。涵盖 OHLC、财务数据、公告、境外报告和 RAG 检索。
workshop	（minimal 的别名——相同的 3 个技能）	历史预设曾捆绑 7 个以 -client 为主的技能，但大多数账户都会因 ISSUE-007 而受阻，导致实时演示无法正常运行。现在该预设指向与 minimal 相同的 3 个技能，因此不再会给研讨会安装带来隐患。
full	全部 19 个技能	同时包含两条系列，适合探索完整的 Gangtise 目录。如果账户缺少 skills-backend/* ACL，大多数 -client 技能将在运行时失败——请先通过 ISSUE-007 中的诊断确认。

能力 2：配置凭据

每个 Gangtise 技能都需要一个与其 Python 运行时位于同一目录的 .authorization 凭据文件，格式有以下两种：

格式 A — accessKey + secretAccessKey（最常见，会自动刷新令牌）：

{
  "accessKey": "<your-accessKey>",
  "secretAccessKey": "<your-secretAccessKey>"
}

格式 B — 长期令牌（高级用法，适用于预先生成的长期令牌）：

{
  "long-term-token": "Bearer <token>"
}

由于 19 个技能都需要相同的 .authorization 文件，包装器会在 ~/.config/gangtise/authorization.json（XDG 标准，权限模式为 600）中存储一个共享文件，并将每个技能的本地凭据文件符号链接到该文件。轮换凭据时只需编辑一个文件，而不是 19 个。

运行配置程序：

bash scripts/configure_auth.sh

程序将：

1. 提示输入 accessKey 和 secretAccessKey（如果已设置 GANGTISE_ACCESS_KEY / GANGTISE_SECRET_KEY 环境变量，则从中读取）。
2. 以 600 权限模式写入 ~/.config/gangtise/authorization.json。
3. 向 https://open.gangtise.com/application/auth/oauth/open/loginV2 发起实时身份验证调用，以验证凭据是否有效。
4. 将上游 CLI 脚本所需的原始运行时令牌写入 ~/.GTS_AUTHORIZATION。
5. 将每个已安装技能的本地凭据文件符号链接到共享 XDG 文件。
6. 根据 Gangtise 身份验证服务返回的 uid 和 userName 报告成功。

轮换凭据

# Edit one file:
$EDITOR ~/.config/gangtise/authorization.json

# Re-verify against the live server:
bash scripts/configure_auth.sh --verify-only

无需更改其他文件——符号链接仍指向已更新的文件。

能力 3：诊断安装状态

bash scripts/diagnose.sh

诊断脚本严格只读。它会检查：

• 每个已检测到的 Agent 的 skills/ 目录中安装了 19 个技能中的哪些
• ~/.config/gangtise/authorization.json 是否存在且权限模式为 600
• 每个技能的本地凭据文件是否为指向共享 XDG 文件的有效符号链接
• 存储的凭据是否通过实时身份验证调用（仅需调用 oauth/open/loginV2 的简短探测）
• 规范 RAG 端点是否能响应最小查询。结果会区分成功响应且包含匹配项、成功但结果为空、身份验证拒绝、权限拒绝、配额／授权响应、响应格式错误和网络故障。脚本会保留 HTTP 状态、API 代码、errorType 和 traceId，但不会打印凭据或完整令牌响应。

退出代码：

• 0 — 一切正常
• 1 — 存在一个或多个需要用户处理的问题
• 2 — 诊断本身失败（网络错误、无互联网等）

如果诊断报告了问题，请对照 references/known_issues.md 中的内容。每个报告的问题都对应一个具体的修复部分。

能力 4：技能注册表——“哪个技能能回答我的数据问题？”

这是包装器不显而易见的价值所在。Gangtise 的 19 个技能构成一个二维矩阵（数据层级 × 操作类型），但相关文档并未清晰说明。使用下表，将用户问题路由到合适的技能：

数据层技能（6）

需求	上游技能	调用方式
跨知识库查询语义内容（报告 + 观点 + 纪要）	gangtise-kb-client	使用带 -q 查询词以及可选 --file-types / --securities 的 kb runner
按类型 + 日期 + 证券列出文档（报告、公告、摘要、观点、路演）	gangtise-file-client	使用各文档类型专用的 runner（report / opinion / summary / announcement / investment_calendar / foreign_report / internal_report / wechat_message）
获取 A 股或港股的 OHLC 日线 K 线	gangtise-data-client	使用带 --securities {name} + -sd / -ed 日期范围的 quote runner
获取财务报表（利润表 / 资产负债表 / 现金流量指标）	gangtise-data-client	使用带 --securities {name} + --indicators 的 financial runner
获取估值指标（PE / PS / PB / PEG + 历史分位数）	gangtise-data-client	使用带 --securities {name} 的 valuation runner
获取主营业务构成（按产品 / 行业 / 地区）	gangtise-data-client	使用带 --securities {name} + --classify-method 的 main_business runner
获取股东 / 前十大股东数据	gangtise-data-client	使用带 --securities {name} 的 shareholder runner
获取宏观 / 行业指标（GDP、CPI、汽车销量、大宗商品价格）	gangtise-data-client	使用带 -k {keyword} 的 industry_indicator runner
按名称查询证券标准代码	gangtise-data-client	使用带 -k {name} 的 security runner
按主题或行业列出板块成分股	gangtise-data-client	使用带 -k {theme} 的 block_component runner
按类别列出指数成分股	gangtise-data-client	使用带 -k {index type} 的 index runner
搜索 Gangtise 内部知识库中没有的公开信息	gangtise-web-client	使用带 -q {query} 的 web runner

完整的各 runner 参数参考和跨技能组合示例，请参阅 references/skill_registry.md。

工作流层技能（10）——高阶研究工作流

这些技能将数据层技能编排为端到端研究工作流。它们会按照 Gangtise 的专业投资研究模板生成 Markdown + HTML 报告，并遵循内置合规防护要求（不得使用“买入 / 卖出 / 目标价 / 推荐”等表述）。

需求	使用
生成 L1-L4 深度的个股研究报告（L1 = 1 页框架，L4 = 完整机构覆盖）	gangtise-stock-research
对投资论点进行对抗性分析（“针对这一看多判断扮演反方”）	gangtise-opinion-pk
开展主题 / 行业研究（驱动因素分析、枚举阶段、个股筛选、表现检查）	gangtise-thematic-research
根据研究标准筛选股票	gangtise-stock-selector
撰写一篇 800-1000 字的市场事件复盘	gangtise-event-review
生成公司访谈提纲（3 步工作流：数据 → 主题 → 问题）	gangtise-interview-outline
跟踪股票池的近期公告并生成每日摘要	gangtise-announcement-digest
总结首席分析师近期的观点	gangtise-opinion-summarizer
将微信群聊记录整理为结构化投资日报	gangtise-wechat-summary
获取设计自定义数据处理工作流的方法指导	gangtise-data-processor

实用技能（3）

技能	用途
gangtise-stockpool-client	创建、重命名或删除股票池；向其中添加或移除股票。仅在 gangtise-skills-client.zip 中分发。
gangtise-file-client-no-download	file-client 的变体，禁用下载功能，适用于只读环境或对合规要求严格的场景。
旧版 gangtise-data / gangtise-file / gangtise-kb	较早的精简并行版本。data 为 v1.2.0，使用严格类型的证券代码（不解析名称）。仅在用户需要更精简的功能时安装。

请参阅 references/skill_registry.md，了解各技能脚本的完整目录、版本和能力矩阵。

此技能拒绝执行的操作

• 将任何 gangtise-* 技能的内容引入、分叉或镜像到此目录中——这里只引用规范的 OBS URL。
• 在 SKILL.md 中固定上游技能版本——安装程序始终下载当前的 OBS 构件。
• 静默修改上游文件——任何修改路径（若将来添加）都必须通过 AskUserQuestion 获得明确同意。
• 硬编码个人 accessKey / secretAccessKey 值。
• 提供投资建议或做出交易决策。Gangtise 自有技能已执行这些合规规则；此封装层严格委托处理。

文件布局

gangtise-copilot/
├── SKILL.md                         # This file
├── scripts/
│   ├── install_gangtise.sh          # Download bundles → stage → distribute
│   ├── configure_auth.sh            # Set up + verify credentials
│   └── diagnose.sh                  # Read-only health report
├── references/
│   ├── installation_flow.md         # How the installer works, flag reference, troubleshooting
│   ├── credentials_setup.md         # accessKey / secretAccessKey, XDG paths, liveness check
│   ├── skill_registry.md            # Complete per-skill capability matrix
│   ├── known_issues.md              # Two parallel product lines, bundle-only skills, and other gotchas
│   └── best_practices.md            # How to combine stock-research + opinion-pk + data-client effectively
└── config-template/
    └── authorization.json.example   # Credential file template (placeholder values only)