gangtise-copilot

Gangtise Copilot

Gangtise（岗底斯投研）のOpenAPIスキルスイート全体に対応する、ワンコマンドインストーラー、認証情報設定ツール、診断レイヤーです。

---

🚀 ワンショットインストール（完全な手順）

ゼロからGangtiseを完全に使える状態にするために読む必要があるのは、このセクションだけです。手順に沿って進めてください。

ステップ1 — このスキルをエージェントのスキルディレクトリにダウンロードする

主な方法（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へのネットワーク接続は不安定な場合があります。ファイルのダウンロードに失敗した場合は、失敗したファイルだけを2秒間隔で最大3回再試行してください。単一ファイルのダウンロード失敗で、処理全体を中止しないでください。

ステップ2 — このスキルをエージェントに登録する

OpenClawの場合：エージェントのスキルディレクトリにシンボリックリンクを作成し、ゲートウェイ設定で有効にしてください：

# 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

ステップ3 — Gangtise公式スキル19個をすべてインストールする

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

実行内容：Huawei Cloudの公式OBSバケットからZIPバンドルを4個ダウンロードし、スキルディレクトリを19個展開して、検出されたエージェントのスキルディレクトリ（~/.openclaw/skills/、~/.claude/skills/など）にシンボリックリンクを作成します。

既知のエージェントのスキルディレクトリパス（自動検出で見つからない場合）：

エージェント	スキルディレクトリ
Claude Code	~/.claude/skills/
Codex	~/.agents/skills/
OpenClaw	~/.openclaw/skills/または<agent-workspace>/skills/

インストールに失敗した場合は、references/installation_flow.mdを確認してください。

ステップ4 — 認証情報を設定する

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

実行内容：

1. ~/.config/gangtise/authorization.jsonを書き込みます（モード600）。
2. 認証情報が機能することを確認するため、認証APIを実際に呼び出します。
3. ランタイムトークン~/.GTS_AUTHORIZATIONを書き込みます。
4. インストール済みスキルごとに、<gangtise-skill-dir>/scripts/.authorizationから共有認証情報ファイルへのシンボリックリンクを作成します。

⚠️ 重要：ステップ3の後、認証情報が存在していても、diagnose.shで「19 skill(s) missing .authorization」と表示される場合があります。~/.config/gangtise/authorization.jsonがすでに存在する場合でも、ステップ4を実行してください。configure_auth.shが不足しているシンボリックリンクを作成します。

ステップ5 — インストールを確認する

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

期待される出力：❌の行がないこと。合格数は、インストールされているエージェントとプリセットによって異なります。OAuthチェックが成功しても確認できるのは、認証情報からトークンを発行できることだけです。RAGの行には、別途、接続可能、空の結果で成功、権限拒否、認証拒否、割り当て量または利用資格に関する応答のいずれかが表示されます。

❌または⚠️が残っている場合は、references/known_issues.mdと照合してください。

ステップ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 は、中国の専門的な投資調査データプラットフォームです。調査レポート、企業発表、会議の要約、チーフアナリストの見解、財務諸表、評価指標、OHLC 市場データ、株主データ、業界指標、および事前構築済みの調査ワークフロースキルのカタログを網羅する OpenAPI を公開しています。基盤となる API は適切に設計されていますが、スキルのエコシステムは見つけにくい状態です。19 個のスキルを一覧にした公開マニフェストがなく、スキルは一覧表示権限が無効になった Huawei Cloud OBS バケット上の個別の ZIP ファイルとして配布されており、さらに、異なる機能セットを持つ 2 つの並行した命名規則（最小構成の gangtise-<name> と、全機能構成の gangtise-<name>-client）が存在します。初めて利用するユーザーは、インストールする前に、スキルの全容をリバースエンジニアリングして把握する必要があります。

Gangtise Copilot は、次の処理を 1 つのコマンドで行います。

1. バンドル済みダウンロードと配布のパイプラインを通じて、公式 Gangtise スキル 19 個すべてを Claude Code、OpenClaw、Codex にインストールします。
2. open.gangtise.com/application/auth/oauth/open/loginV2 に対する認証呼び出しを実行しながら、accessKey と secretAccessKey の設定をユーザーに案内します。
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 エイリアス、full、またはカスタムの --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 は、Huawei Cloud OBS バケットで 19 個の独立したスキルを公開しています。これらは 3 つのバンドル ZIP と 1 つの単独 ZIP にまとめられています。インストーラーは 4 つのアーカイブをダウンロードし、19 個のスキルディレクトリを展開して、検出されたエージェントのスキルディレクトリにそれぞれシンボリックリンクを作成します。

配布元

すべてのスキルは、公式の 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（単独。どのバンドルにも含まれていません）

合計：HTTP リクエスト 4 回 → スキルディレクトリ 19 個。

2 つのスキル（gangtise-file-client-no-download と gangtise-stockpool-client）は、gangtise-skills-client バンドルの中にしか存在しません。単独 ZIP はありません。「各スキルの単独 ZIP を列挙する」という単純な方法では、これらを完全に見落とします。詳しくは references/known_issues.md の ISSUE-002 を参照してください。

1 コマンドでインストール

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 つのスキル）	以前のプリセットには -client 系のスキルが 7 つ含まれていましたが、ほとんどのアカウントでは ISSUE-007 によってブロックされ、ライブデモが正常に動作しません。現在、このプリセットは minimal と同じ 3 つのスキルを指定するため、ワークショップで誤って問題を起こすことはありません。
full	全 19 スキル	2 つのラインを並行して使用します。Gangtise のカタログ全体を試すのに便利です。アカウントに skills-backend/* ACL がない場合、ほとんどの -client スキルは実行時に失敗します。まず ISSUE-007 の診断で確認してください。

機能 2：認証情報を設定する

Gangtise の各スキルには、Python ランタイムと同じ場所に .authorization 認証情報ファイルが必要です。形式は次の 2 種類です。

形式 A — accessKey + secretAccessKey（最も一般的で、トークンを自動更新します）：

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

形式 B — 長期トークン（高度な設定で、事前に生成された長期有効トークンを使用します）：

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

19 個のスキルそれぞれに同じ .authorization ファイルが必要なため、ラッパーは ~/.config/gangtise/authorization.json（XDG 標準、モード 600）に共有ファイルを 1 つ保存し、各スキルのローカル認証情報ファイルからそのファイルへのシンボリックリンクを作成します。認証情報をローテーションする場合、編集するファイルは 19 個ではなく 1 個です。

設定ツールを実行します。

bash scripts/configure_auth.sh

このツールは次の処理を行います。

1. accessKey と secretAccessKey の入力を求めます（設定されている場合は、GANGTISE_ACCESS_KEY / GANGTISE_SECRET_KEY 環境変数から読み込みます）。
2. ~/.config/gangtise/authorization.json にモード 600 で書き込みます。
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

診断スクリプトは 読み取り専用 です。次の項目を確認します。

• 検出された各エージェントの skills/ ディレクトリに、19 個のスキルのうちどれが存在するか
• ~/.config/gangtise/authorization.json がモード 600 で存在するか
• 各スキルのローカル認証情報ファイルが、共有 XDG ファイルを指す有効なシンボリックリンクか
• 保存された認証情報が実際の認証呼び出しに合格するか（oauth/open/loginV2 のみを必要とする簡易プローブ）
• 標準の RAG エンドポイントが最小限のクエリに応答するか。結果では、マッチを含む応答の成功、空の応答の成功、認証の拒否、権限の拒否、クォータ／権限付与に関する応答、不正な形式の応答、ネットワーク障害を区別します。認証情報やトークン応答全体を出力することなく、HTTP ステータス、API コード、errorType、traceId を保持します。

終了コード：

• 0 — すべて正常
• 1 — ユーザーの対応が必要な問題が 1 つ以上あります
• 2 — 診断自体が失敗しました（ネットワークエラー、インターネット接続なしなど）

診断で問題が報告された場合は、出力を references/known_issues.md と照合してください。報告された各問題には、個別の対処方法のセクションが対応しています。

機能 4：スキルレジストリ — 「自分のデータに関する質問に答えるスキルはどれか？」

これが、このラッパーの一見わかりにくい価値です。Gangtise の 19 個のスキルは、明確に文書化されていない 2 次元のマトリックス（データ階層 × 操作タイプ）を構成しています。この表を使って、ユーザーの質問に適したスキルに振り分けてください。

データレイヤーのスキル（6）

目的	上流のスキル	呼び出し方法
ナレッジベース全体（レポート＋意見＋議事録）からセマンティックコンテンツを検索する	gangtise-kb-client	kb runner に -q クエリと、任意で --file-types ／ --securities を指定
種類＋日付＋銘柄でドキュメントを一覧表示する（レポート、発表、サマリー、意見、ロードショー）	gangtise-file-client	ドキュメントの種類ごとの専用 runner（report / opinion / summary / announcement / investment_calendar / foreign_report / internal_report / wechat_message）
A株または香港株の日足 OHLC データを取得する	gangtise-data-client	quote runner に --securities {name} と -sd ／ -ed の日付範囲を指定
財務諸表（損益計算書／貸借対照表／キャッシュフロー計算書の指標）を取得する	gangtise-data-client	financial runner に --securities {name} と --indicators を指定
バリュエーション指標（PE ／ PS ／ PB ／ PEG ＋過去のパーセンタイル）を取得する	gangtise-data-client	valuation runner に --securities {name} を指定
主力事業の構成（製品／業種／地域別）を取得する	gangtise-data-client	main_business runner に --securities {name} と --classify-method を指定
株主／上位株主のデータを取得する	gangtise-data-client	shareholder runner に --securities {name} を指定
マクロ／業界指標（GDP、CPI、自動車販売台数、商品価格）を取得する	gangtise-data-client	industry_indicator runner に -k {keyword} を指定
名称から銘柄の標準コードを調べる	gangtise-data-client	security runner に -k {name} を指定
テーマまたは業種でセクター構成銘柄を一覧表示する	gangtise-data-client	block_component runner に -k {theme} を指定
カテゴリー別に指数構成銘柄を一覧表示する	gangtise-data-client	index runner に -k {index type} を指定
Gangtise の社内ナレッジベースにない公開情報をウェブ全体から検索する	gangtise-web-client	web runner に -q {query} を指定

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
WeChat のグループチャットの議論ログを、構成された投資日報にまとめる	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)