> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/agent-an-li/gold-price-case.md).
# 金価格暴落に困惑？Kimi K2.5 + Cherry Studioで「振り返り神器」を作ってみた（Agent設計＋完全チュートリアル付き）
最近ゴールドが急落して、真っ先に頭に浮かぶのは：逃げるべき？ 買い向かうべき？\
でも振り返ってみると、ゴールドのような資産が最も得意なのは「市場に強さを見せつける」ことだ。激しい値動きには、実はしばしば歴史の影が見える：
* **マクロ予想が突然転換**（金利/インフレ/ドル高）、ゴールドは急速に押し戻されやすい
* **リスクイベントの高まり**（紛争、金融システムへの圧力）、安全資産需要が再び価格を押し上げる
* **流動性逼迫**時には、むしろ「先に下げて後で上がる」という逆説的な動きが起きる
問題は：ニュースを10本読んでも得られるのは感情だけ。でもあなたに必要なのは**証拠の連鎖**。\
ちょうど最近、月之暗面が発表しオープンソース化した **Kimi K2.5** モデル。——これはKimi史上最もスマートで最も万能なオープンソースモデルで、 **Agent、コード、画像/動画** などのタスクでオープンソースSOTAを達成している。
\
**そこで、私は大胆な発想を思いついた：** 人間の脳ではこれほど雑多な情報を処理しきれないなら、**Kimi K2.5をCherry StudioのAgentの中に住まわせて、今回の「ゴールド暴落」を徹底的に洗い出してもらえないだろうか？**
今日の記事は、退屈な説明書ではなく、最新モデルと最強クラスのAgentスキルを使って、24時間待機の金融分析チームを自分用に用意する方法を紹介するものだ。文末ではこのAgentのフォルダを提供する `Kimi Agent`。
ダウンロードして3分設定するだけで動かせる。以下では、設計ロジック、フォルダ構成、コンポーネントの分解、実行フローまで、全部解説する。Kラインを見ながら「押し目買いすべきか」と悩んでいるなら、あるいはニュースの爆撃で真因が見つからないなら、これが必要だ。
## **なぜこう設計したのか？（3つの論理、遠回しにしない）**
1. **データの真実性を最優先、捏造はゼロ容認**：金融分析で最も怖いのは「AIの幻覚」だ。だから各ステップで出典＋タイムスタンプの明記を必須にし、取得できなければエラーにする（推測しない）。公開ソース（Kitco、Investing.comなど）ならAPIキー不要で始められる。
2. **タスクをモジュール化して並列化**：Kimi K2.5の強みは「Agentクラスター」（自律分身、1500ステップ並列）にある。Cherry StudioのSkills＋Sub-agentsでこれを再現する。データ取得、ニュース収集、レポート生成を三方向で同時進行させ、効率を倍増させる。
3. **出力の現代化**：Markdownは出さない（もう純テキストを見る人なんている？）。直接HTML（Chart.jsのグラフ＋レスポンシブレイアウト）を生成し、Kimi K2.5のコード生成能力に合わせる。
結果：レポート1本 = 1年近くの推移グラフ＋急落タイムライン＋3つのシナリオ予測＋全出典リンク。上司やグループにそのまま送れる。
### **📁 フォルダ構成：なぜClaude Codeと互換なのか？**
核となるのは `.claude/` ディレクトリだ——Cherry Studioはこれを認識し、Skillsと設定を自動で読み込める。完全な構成はあなたの `06-DIRECTORY_STRUCTURE.md`に由来する：
```python
Kimi Agent/ # プロジェクトルート
├── .claude/ # Cherry Studio Agentのコア設定領域
│ ├── prompts/ # システムプロンプト（バイリンガル）
│ │ ├── system_prompt_cn.md # 中国語版：Agentの挙動 + データ真実ルールを定義
│ │ └── system_prompt_en.md # 英語版
│ ├── skills/ # 3つのコアSkills（自動認識）
│ │ ├── skill_financial_data_fetcher.md # データ取得 + 検証
│ │ ├── skill_geopolitical_analyst.md # 事象分析 + タイムライン
│ │ └── skill_financial_report_generator.md # HTMLレポート生成
│ ├── agents/ # Sub-agents設定
│ │ ├── subagent_financial_intelligence.md # 定量分析サブモジュール
│ │ └── subagents_usage_strategy.md # 協働戦略
│ ├── config/ # パス/ツール設定
│ │ └── paths.conf
│ ├── settings.json # 主設定：モデル + プロンプトパス + ツール一覧
│ └── mcp.json # MCP（ツールサーバー）設定
├── docs/ # ドキュメントのバックアップ（README、データソース、更新履歴）
├── start-gold-agent.sh # ワンクリック起動スクリプト（任意）
├── USER_PROMPT_EXAMPLE.md # サンプル指示
└── バックアップディレクトリ（core_config/ skills/ など）# 元ファイルのバックアップ、実行には参加しない
```
**なぜこう分けるのか？**
* `.claude/` Cherry Studioの標準認識パスだからだ：ワークディレクトリを選ぶと、自動でSkillsを読み込む（ファイル名 `skill_*.md` → Skill名 `financial-data-fetcher`）。
* バックアップ領域で紛失を防ぐ：元のSkillsはルートの skills/ にあり、実行時は `.claude/skills/`。
### **🔧 コアコンポーネントの分解：3つのSkills + プラグイン + Sub-agents**
#### **🧩 3大コアSkillsの設計詳細**
では、この3つの「分身」が具体的にどう設計されているのか、そしてなぜそう設計するのかを見てみよう。
**Skill A：`financial-data-fetcher` （データハンター）——幻覚を拒否**
* **設計上の痛点**：汎用LLMは価格を「でっち上げる」のが最も得意だ。金価格を聞くと、2023年のデータを勝手に捏造してくるかもしれない。
* **Skillロジック**に由来する：
* **ハード制約**：Promptにルールを固定で書く——*「訓練データ内の価格を使うことを禁止し、必ずツールを呼び出すこと」*。
* **ツールチェーン**： `WebFetch`を備える。百度で「検索」するのではなく、指定したデータソースのページ（Kitco、GoldPrice.org、LBMAなど）を直接「クロール」する。
* **データクレンジング**：取得した雑多なHTMLを、きれいな `JSON` 形式（タイムスタンプ、始値、終値、騰落率）に整える。
* **Kimi K2.5の役割**：その強力な**長文書抽出能力**を使い、数万行のWebコードからその `$2,xxx.xx` の数字を正確に特定する。
**Skill B：`geopolitical-analyst` （地政学ロジック庫）——ノイズを拒否**
* **設計上の痛点**：ゴールド急落の原因は多い（金利上昇？ 戦争？ 売り浴びせ？）。普通の検索では、マーケ垢のフェイクニュースまで吸い込んでしまう。
* **Skillロジック**に由来する：
* **多元ソース照合**：『金価格』を検索するだけでなく、『ドル指数(DXY)』『FRB議事要旨』『地政学情勢』も並行検索する。
* **時間同期**：核心ロジックとして、次を実行する——**「TimeStamp Matching」**。
* *発見：* ゴールドがUTC 14:30に急落。
* *検索：* UTC 14:30に何が起きた？
* *照合：* 米国がUTC 14:30に予想を上回るCPIデータを発表したことを発見。
* *結論：* 急落はインフレデータが引き金。
* **Kimi K2.5の役割**：その **Agentクラスター（分身）能力**を利用して、「同時に20本のニュースを読む」ことをシミュレートし、感情的なノイズを除去して事実だけを残せる。
**Skill C：`financial-report-generator` （フロントエンドエンジニア）——凡庸を拒否**
* **設計上の痛点**：これもCherry Studioの最も驚くべき一歩だ。ほとんどのAgentはMarkdownの文章を返すだけで、表ですらガタガタだ。
* **Skillロジック**に由来する：
* **コード優先**：このSkillは「コード言語しか話さない」ように訓練されている。文章は書かず、HTML + CSS + JavaScriptを書く。
* **動的インタラクション**：プログラミング経験がなくても、このコンポーネントは `Chart.js` ライブラリを呼び出し、コンポーネントAが取得したデータを、拡大縮小可能でホバー表示できるローソク足チャートに変換する。
* **視覚統合**：コンポーネントBの分析結論を、「カード」や「タイムライン」の形でWebレイアウトに埋め込む。
* **Kimi K2.5の役割**：その強化された **Code（プログラミング）** 能力、特にフロントエンド構築能力を活用する。Kimi K2.5が生成するコードは非常に堅牢で、ほとんど手動デバッグなしでブラウザ上でそのまま動く。
\
#### **このAgentにおけるSub-agentの位置づけとは？🧩**
以下では **Kimi Agent（ゴールド市場分析Agent）** の中の「Sub-agent（サブエージェント）」の層をはっきり説明しよう：それらは何か、なぜ使うのか、どう協力するのか、フォルダ内で何が見えるのか。
> *まずはっきり言うと：* ***Skills** は、より「再利用可能なプロセスモジュール」に近く、**Sub-agent** は、より「独立した作業手順書を持つ専任役割」に近い。*
\
主Agent（Cherry Studioで作成する `Gold Market Analysis Agent`）が担うのは3つ：
1. **タスク分解**：『ゴールドの動向分析/急落の振り返り/レポート作成』をいくつかの独立したサブタスクに分ける
2. **タスク割り当て**：サブタスクを異なるSub-agentに振り分ける（各サブエージェントには明確な境界と出力形式がある）
3. **検収と集約**：データに出典とタイムスタンプがあるか、欠損がないかを確認し、最後にレポート生成モジュールへ渡してHTMLを出力する
なぜ1つのAgentに全部やらせないのか？
* なぜなら、「データを探す、ニュースを読む、指標を計算する、フロントエンドレポートを書く」は、それぞれコンテキストとツール呼び出しへの要求が違うからだ。全部を1つのPromptに詰め込むと、最もズレやすい。
* 分けておけば、各サブエージェントのルールをより厳密に書ける：**どのツールを使ってよいか、どんな構造で出力するか、失敗したときどう処理するか**。
\
**この構成にはどんなSub-agentがある？それぞれ何をする？✅**このパッケージのSub-agentは主に3種類だ（2種類はシステム既定、1種類はカスタム）：
**A. システム既定：`search-specialist`（検索と資料整理）**
* **name**: `search-specialist`
* **役割**：高度な検索、結果の絞り込み、ソース横断の検証、引用整理
* **出力の特徴**：検索戦略、ソースURL、重要引用を提示する（「急落のトリガー要因タイムライン」を作るのに適している）
ゴールド分析で使うと、通常は次を担当する：
* 『急落』のニュース源、公開時刻、キーフレーズ
* 中央銀行、マクロデータ発表（CPI、金利決定など）に対応する公式/権威ソースページ
* 同一指標の複数ソース検証（Kitco vs GoldPrice vs Investing など）
**B. システム既定：`business-analyst`（指標と相関分析）**
そのツールは `Read, Write, Bash`で、**構造化分析**に由来する：
* 相関（ゴールド vs DXY、ゴールド vs 実質金利）
* ETF保有量の変化（SPDR Gold Trustなど）
* KPI計算（年率ボラティリティ、ドローダウンなど——真のデータが取得できた場合）
その価値は：**『分析に見える』記述を、『計算可能で、途中経過がある』結論に変えること。**
**C. カスタムSub-agent：`financial-intelligence-agent`（歴史データ/テクニカル指標/予測）**
パス：`.claude/agents/subagent_financial_intelligence.md`これは、より『量的パイプライン』寄りの仕事をカバーする：
* 過去データを取得する（OHLCV、経済指標、金利、インフレなど）
* RSI / MACD / ボリンジャーバンド / 移動平均 / ボラティリティを計算する
* 追跡可能な中間ファイル群を出力する：CSV、JSON（例えば `gold_technical_indicators.csv`、`correlation_analysis.json`、`gold_price_forecast_12m.csv`）
> *この層は特に重要だ：『テクニカル分析』を会話内容から切り離し、ディスクに書き出せる成果物にする。その後の再利用、比較、共有がしやすい。*
#### **Sub-agentはどう「スケジューリング」されるのか？（並列戦略）⚙️**
このシステムはまず **並列**を優先する。ゴールドの振り返りは本質的にマルチソース情報タスクだからだ。
**Phase 1：並列収集（待ち時間を減らす）**
* `search-specialist`：『急落当日の主要ニュース/データ公開タイムライン』を検索
* `financial-intelligence-agent`：過去1年の価格系列を取得 + 指標計算
* `business-analyst`：相関を計算し、ETF/マクロの説明フレームを整理
**Phase 2：直列計算（依存関係のあるものを後ろへ）**
* 歴史データが書き出された後にのみ、指標/ボラティリティ/サポート・レジスタンス等を計算
* データ欠損が見つかれば、再び `search-specialist` ソースを補う
**Phase 3：集約して納品**
* 主Agentが3方向の結果を「タイムスタンプをそろえ、口径をそろえる」
* その後、レポート生成モジュールを呼び出してHTMLを出力する（グラフ、タイムライン、引用リスト付き）
これが、このAgentが「ホットな場面」で強い理由だ： **ゴールド急落 = 情報が濃密 + 口径が乱れる**、並列の証拠収集 + 検証 + 集約により、「たくさん見たのに、さらに混乱する」状況を大きく減らせる。
***
#### **Sub-agentとSkillsの関係：混同しないように🤝**
あなたのパッケージでは、両者は補完関係にある：
* **Sub-agent**：より「専用の作業モード」に近く、『誰がやるか、どうやるか、どのツールを使うか、どんな形式で出力するか』の問題を解く
* **Skills（.claude/skills/）**：より「繰り返し呼べるプロセスモジュール」に近く、『このステップをどう安定して実行するか』の問題を解く 例えば：
* `financial-data-fetcher`：多元検証を強調し、数字の創作を禁止し、構造化データを出力する
* `geopolitical-analyst`：イベント分類、因果メカニズム、タイムライン形式を強調する
* `financial-report-generator`：HTMLテンプレート、Chart.js、ソース一覧、印刷可能スタイルを強調する
簡単に言うと： **Sub-agentは仕事を振り分ける役目を担い、Skillsは各ステップをより安定し、再利用しやすくする。**
#### **フォルダ内でSub-agentが「本当に有効か」をどう確認する？🔍**
2つの場所を見れば十分だ：
1. **ディレクトリが標準か**
1. `.claude/agents/` に `subagent_financial_intelligence.md`
2. **実行ログ**（Cherry Studio内）
1. ツール呼び出しとタスク分担の痕跡（WebSearch/WebFetch/Bash/Write）が見える
2. 最終的に出力ファイルが生成される：例えば `gold_analysis_report.html`、中間成果物が含まれる設定ならCSV/JSONも出力される
もっと「目立たせたい」なら、主Promptに次のようなハード制約を追加できる：
> *「レポート付録に、今回どのsub-agent / skillsを呼び出したか、およびそれぞれの出力ファイル名を列挙してください。」*
こうすれば、読者は一目で分かる：これはチャットではなく、パイプラインだ。
## **🛠️ 実践チュートリアル：3ステップで自分専用Agentを再現**
コードを書く必要も、環境を整える必要もない。私は**「Kimi Agent」フォルダ**をパッケージしたので、「コピー＆ペースト」できれば使える。
### **Step 1：モデル設定（月之暗面 の `kimi-K2.5` + Anthropicエンドポイント）**
これはAIを賢くする中核だ。
1. Cherry Studioを開く → **モデルサービス** → クリック **月之暗面**
2. 月之暗面のオープンプラットフォームへ移動して **API Key**を取得（モデル呼び出しに必要。データ取得に追加キーは不要）
**⚠️ 強力な注意（必須）：** Cherry Studioの設定で、 **「エンドポイントタイプ (Endpoint Type)」** を必ず `Anthropic`。
* *に変更すること* なぜ変更するのか？
\
### **Cherry StudioのAgentプロトコルはAnthropicエンドポイントモードで動かす必要があり、そうして初めてKimi K2.5が前述のSkillsを完璧に制御できるからだ。 `Kimi Agent`）**
> 文末で、名前が `Kimi Agent` のフォルダを用意しているが、中にはすべてのスキルがあらかじめ入っているので、Skills/Sub-agentを手作業で書き直す必要はない。
1. Cherry Studio → アシスタント一覧の横で **+** をクリック → **Agentを作成**
2. 名前：`Gold Market Analysis Agent`（または好きな名前）。
3. モデル：先ほど設定した **月之暗面 /** `kimi-K2.5`
4. 作業ディレクトリ：ダウンロードして展開した `Kimi Agent` フォルダを選択
5. フォルダ内のシステムプロンプト（例えば `.claude/prompts/system_prompt_cn.md`）を開き、Cherry Studioの **システムプロンプト**欄に貼り付ける。
### **Step 3：ツール権限＋プラグイン＋Skillsを開く（すべてチェック）**
1. **権限を有効化**：Agent設定で権限を有効にし、ツールを許可する（1つでも欠けると止まる可能性がある）：
* `bash`
* `fetch`
* `edit`
* `multiedit`
* `webfetch`
* `web search`
* `write`
2. **プラグイン設定：**
システム既定 plugin を追加：
* `business-analyst`
* `search-specialist`
システム skills：
* `Excel Analysis`
## **「魔法」を目撃する**
すべて準備完了。フォルダ内の `USER_PROMPT_EXAMPLE.md`を開くと、中に書かれた**深度指令**があるので、そのままコピーしてAgentへ送る。**この指令はAgentに3つのことをさせる：**
1. **調べる**：ゴールド急落の具体的な下落幅と発生時刻を検索する。
2. **探す**：Kimi K2.5のネット接続能力を使って、月之暗面の新モデル機能に関する公式説明を探す（勝手にでっち上げない）。
3. **比べる**：過去の類似した急落パターンを探し、どのような「写し」関係があるか分析する。
### **📊 最終的な見え方：何を提出したのか？**
送信をクリックすると、Agentが猛烈に動き始める。ログには次が表示される：`Thinking...` -> `Searching News...` -> `Calculating...`しばらくすると、つまらない一文ではなく、1本の **HTML形式の詳細なリサーチレポート**に由来する：
* 📈 **直近1年間の金価格推移の可視化**（グラフ＋表）
* 🧷 **重要な急騰/急落区間の注記**（特に「急落」）
* 🗓️ **イベントのタイムライン**（各イベントに出典リンク付き、検証可能）
* 📊 **テクニカル指標/相関分析**（データがあれば計算し、欠損があれば明記）
* 🔮 **3つのシナリオ予測**（条件、レンジ、リスク注意を明確に記載）
* 🧾 **データソース一覧**（URL + 取得時刻のタイムスタンプ）
\
**最終的に、あなたが手にするのは** `gold_analysis.html` **というファイルで、開けばすぐ見られます：**
***
## **💭 最後に**
今回の体験で私が最も驚いたのは、Kimi K2.5 がどれだけ強くなったかでも、Cherry Studio がどれだけ使いやすいかでもありません。驚いたのは **「確実性」**です。金融市場では、情報はお金そのものです。
以前は勘に頼っていましたが、今はAgentに頼れます。Kimi K2.5 を Cherry Studio に組み込むことで、実は自分のために**「絶対に理性的で、24時間オンライン、データの出典を追跡可能」**なスーパー社員を雇ったようなものです。
**今回の金の急落をあなたが回避できなかったとしても、このAgentの使い方を身につければ、少なくとも認知の面では、もう十分に取り戻せています。**\
\
あなたが**「複雑なタスクをSkillsコンポーネントに分解する」**という核心ロジックを身につけ、さらに **Kimi K2.5** タスク計画とツール呼び出しの質的飛躍が加われば、以前は「AIにはできない」と思っていたことも、今ではAgentに任せられると気づくはずです：
* **🕵️♂️ 市場偵察兵**： 競合サイトを手作業で巡回したくない？ Agentに10社の競合の最新価格と機能更新を自動収集させ、重複を除去し、毎朝9時に整理済みのExcel比較表をあなたのデスクトップへ送らせましょう。
* **💻 影のプログラマー**： コードが書き終わらない？ 単なるコード補完ではなく、Agentにプロジェクトフォルダ全体を読み込ませ、要件に応じて機能モジュールを自動作成し、ローカルテストを実行し、Bugを修正し、そのついでに完璧なAPIドキュメントまで生成させられます。
* **✈️ 極上の旅人**： ありきたりな旅程ガイドは不要。Agentに予算に応じた航空券とホテルのリアルタイム価格比較をさせ、天候や現地イベントの評価を総合して、分単位まで正確な行程を組ませ、さらにPDFの旅程表まで生成できます。
\
**Agentの本当の魅力は、どれだけ長くあなたと話せるかではなく、自律性と成果物の納品力にあります**——今日の金分析師のように、あなたがコーヒーを飲んでいる間に、黙って仕事を片付けてくれるのです。この**「タスク自動化」**の感覚は、一度体験したら元には戻れません。
ぜひ枠にとらわれず、より本格的で、面白く、実用的なシーンを探ってみてください。業務フローの最適化でも、生活のハイテクネタでも、あなたの奇想天外なアイデアとAgentの設定ファイルをぜひ共有してください。
📩 **投稿と交流**に由来する：\
**未来を待つ必要はありません。あなたのAI Agent時代は、この瞬間すでに始まっています。**
\
👇 **今すぐダウンロードしてKimi K2.5を接続し、あなたの最初のデジタルチームを構築しましょう：**
📥 **付：Kimi Agent設定フォルダのダウンロードリンク：***（Cherry Studio v1.7.0+ がインストールされていることを確認してください）*
\
\
\
***
### 💡 ヘルプの取得とフィードバックの送信
設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルをご参照ください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/agent-an-li/gold-price-case.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.