AIモデル - GLMのソースを表示

== 概要 ==
GLM (General Language Model) は、智譜AI (Zhipu AI、国際ブランド名: Z.ai) によって開発された大規模言語モデルシリーズである。<br>
2021年に発表されたオリジナルのGLM論文では、自己回帰型ブランク充填 (Autoregressive Blank Infilling) という独自の事前学習手法が提案された。<br>
この手法は、BERT的双方向エンコーダとGPT的自己回帰デコーダの利点を統合し、自然言語理解 (NLU) と生成 (NLG) の両タスクにおいて優れた性能を発揮する。<br>
<br>
GLMの主要な技術的特徴を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ GLMの主要な技術的特徴
! 特徴 !! 説明
|-
| 自己回帰型ブランク充填 || 入力テキストの一部をランダムにマスクし、自己回帰的に予測する事前学習手法
|-
| 2次元位置エンコーディング || マスクされたスパンの位置情報を2次元でエンコードし、文脈理解を向上
|-
| 任意順序でのスパン予測 || マスクされた複数のスパンを任意の順序で予測可能とし、柔軟な生成を実現
|-
| 統一された事前学習目標 || NLUタスク、条件付き生成、無条件生成を単一のフレームワークで扱う。
|}
</center>
<br><br>

== 智譜AI (Zhipu AI / Z.ai) ==
智譜AI (Zhipu AI) は、中国の北京市に拠点を置く人工知能企業である。<br>
国際的にはZ.aiというブランド名で展開している。<br>
<br>
==== 会社概要 ====
智譜AIの会社概要を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ 智譜AI 会社概要
! 項目 !! 内容
|-
| 正式名称 || Knowledge Atlas Technology Joint Stock Company Limited
|-
| ブランド名 || Zhipu AI（中国国内）/ Z.ai（国際）
|-
| 旧称 || Beijing Zhipu Huazhang Technology Co., Ltd.
|-
| 設立 || 2019年
|-
| 所在地 || 中国北京市
|-
| 創業者 || 唐傑 (Tang Jie) 教授、李涓子 (Li Juanzi) 教授
|-
| 出身 || 清華大学 (Tsinghua University) 計算機科学科
|-
| 上場 || 2025年1月、香港証券取引所（約43.5億香港ドル調達）
|-
| ミッション || 「機械に人間のように思考させる」
|}
</center>
<br>
智譜AIは、清華大学のKnowledge Engineering Lab（知識工学研究室）からスピンアウトした企業であり、北京人工知能研究院 (BAAI) とも密接な連携関係にある。<br>
中国で最初に上場した生成AIスタートアップ企業として知られ、GPT-3.5の発表 (2022年) より前の2021年には既にGLMの研究論文を発表していた先駆的存在である。<br>
<br><br>

== GLMシリーズの系譜 ==
GLMシリーズは、初代GLMから最新のGLM-5まで、継続的な改良と機能拡張が行われている。<br>
<br>
==== GLMシリーズ一覧 ====
<center>
{| class="wikitable"
|+ GLMシリーズの主要モデル
! モデル !! リリース時期 !! パラメータ数 !! 主な特徴
|-
| GLM || 2021年 || - || 初代モデル<br>自己回帰型ブランク充填を提案
|-
| GLM-2 || 2022年 || - || 第2世代<br>多言語対応を強化
|-
| GLM-3 || 2023年 || - || ツール使用、エージェント機能を追加
|-
| GLM-4 || 2024年 || - || マルチモーダル対応、128Kコンテキスト
|-
| GLM-4.5 || 2025年7月 || - || Mixture-of-Experts (MoE) アーキテクチャ採用
|-
| GLM-4.6 || 2025年 || - || 推論能力強化版
|-
| GLM-4.6V || 2025年 || - || ビジョン対応、128Kコンテキスト、ネイティブFunction Calling
|-
| GLM-4.7 || 2025年12月 || - || コーディング特化、200Kコンテキスト
|-
| GLM-5 || 2026年2月 || 744B (40B活性化) || MoE、Huawei Ascendで学習、エージェント機能強化
|}
</center>
<br>
GLMシリーズの技術的進化のポイントを以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ GLMシリーズの技術的進化
! 進化のポイント !! 説明
|-
| アーキテクチャの進化 || 初期の自己回帰型ブランク充填から、MoE (Mixture-of-Experts) アーキテクチャへの移行
|-
| コンテキストウィンドウの拡大 || 初期モデルからGLM-4.7の200Kトークンまで大幅に拡張
|-
| マルチモーダル化 || GLM-4以降、画像・動画・文書理解に対応
|-
| エージェント機能 || GLM-3以降、ツール使用や自律的なタスク実行機能を追加
|-
| ハードウェア独立性 || GLM-5はHuawei AscendチップとMindSporeフレームワークで学習
|}
</center>
<br><br>

== GLM-4.7の詳細 ==
GLM-4.7は、2025年12月21日にリリースされたGLMシリーズの主力モデルであり、<br>
特にコーディング能力と推論能力に特化して最適化されている。<br>
<br>
==== GLM-4.7の仕様 ====
<center>
{| class="wikitable"
|+ GLM-4.7 モデル仕様
! 項目 !! 仕様
|-
| リリース日 || 2025年12月21日
|-
| コンテキストウィンドウ || 200,000トークン (約205K)
|-
| 料金（API） || $0.60/百万入力トークン、$2.20/百万出力トークン
|-
| 成功率 || 98%（ベンチマーク全体）
|-
| 特徴 || コーディング、推論、エージェントタスクに最適化
|}
</center>
<br>
==== GLM-4.7のベンチマーク性能 ====
GLM-4.7は、GPT-5、Claude Sonnet 4.5、Gemini 3.0 Pro、DeepSeek-V3.2などの<br>
フロンティアモデルと同等以上の性能を発揮する。<br>
<br>
<center>
{| class="wikitable"
|+ GLM-4.7 ベンチマーク結果
! ベンチマーク !! スコア !! 比較対象
|-
| SWE-bench Verified || 77.8% || GPT-5.1-High、Claude Opus 4.5に匹敵
|-
| SWE-bench || 73.8% || Claude 4.5 Sonnetを上回る
|-
| LiveCodeBench V6 || - || Claude 4.5 Sonnetを上回る
|-
| 推論ベンチマーク (8種) || - || 競合モデルと同等以上
|-
| コーディングベンチマーク (5種) || - || 競合モデルと同等以上
|-
| エージェントベンチマーク (3種) || - || 競合モデルと同等以上
|}
</center>
<br>
GLM-4.7は、17種類のベンチマーク（推論8種、コーディング5種、エージェント3種）で他のフロンティアモデルと詳細な比較が行われている。<br>
オープンウェイトモデルとして公開されており、MITライセンスで利用可能である。<br>
<br><br>

== GLM-5の詳細 ==
GLM-5は、2026年2月にリリースされた最新世代のフロンティアモデルである。<br>
<br>
==== GLM-5の仕様 ====
<center>
{| class="wikitable"
|+ GLM-5 モデル仕様
! 項目 !! 仕様
|-
| リリース日 || 2026年2月11日
|-
| 総パラメータ数 || 744億 (744B)
|-
| 活性化パラメータ || 40億 (40B) / トークン
|-
| アーキテクチャ || Mixture-of-Experts (MoE)
|-
| 学習ハードウェア || Huawei Ascend
|-
| 学習フレームワーク || MindSpore
|-
| ライセンス || MIT
|}
</center>
<br>
GLM-5は「Vibe CodingからAgentic Engineeringへ」というパラダイムシフトを目指して設計されており、推論、コーディング、エージェントタスクにおいてオープンソースモデル最高水準の性能を達成している。<br>
また、Huawei AscendチップとMindSporeフレームワークを使用して学習されており、アメリカ製ハードウェアからの完全な独立を実現した点も重要な特徴である。<br>
<br><br>

== Z.ai Coding Planの概要 ==
VS CodeのCline拡張機能とZ.ai GLM-5を直接契約して連携させる方法について示す。<br>
<br>
Z.ai (智譜AI) はGLM-5をコーディングツール向けにサブスクリプション形式で提供しており、月額$10から利用できる。<br>
<br>
GLM Coding Planの主な特徴を以下に示す。<br>
* 5時間ごとにクォータがリセットされる
* Claude Code、Cline、OpenCode、Roo Code、Kilo Code等で利用可能
* Vision Understanding、Web Search MCP、Web Reader MCPが利用可能
* GLM-4.7は200Kトークンのコンテキストウィンドウをサポート
* SWE-bench 73.8%、LiveCodeBench V6でClaude 4.5 Sonnetを上回る性能
<br>
<center>
{| class="wikitable"
|+ GLM Coding Planの料金体系
! プラン !! 月額料金 !! プロンプト数/5時間 !! 特徴
|-
| GLM Coding Lite || $10 (初月半額) || 120プロンプト || 一般的な開発用途向け
|-
| GLM Coding Pro || $30 (初月半額) || 600プロンプト || 高頻度利用向け
|}
</center>
<br>
Clineの機能体系はClaude Codeとは異なる用語を使用する。<br>
<br>
<center>
{| class="wikitable"
|+ Claude CodeとClineの機能対応表
! Claude Code !! Cline !! 説明
|-
| サブエージェント || ネイティブでは同等機能なし || sub-agents-mcp等のMCPサーバを使用して<br>類似機能を実現可能
|-
| スキル || Custom Instructions || グローバルな指示設定
|-
| ルール || .clinerules || プロジェクト固有の規約
|}
</center>
<br><br>

== Z.ai GLM Coding Planの契約手順 ==
==== ステップ 1 : Z.aiアカウントの作成 ====
Z.aiのサブスクリプションページにアクセスしてアカウントを作成する。<br>
* https://z.ai/subscribe
<br>
紹介コード付きのURLを使用すると、追加割引 (10%から20%OFF) が適用される場合がある。<br>
<br>
アカウント作成手順を以下に示す。<br>
# [Sign Up] または [Sign In] を選択する。
# メールアドレスまたはGoogleアカウント等でアカウントを作成する。
# [GLM Coding Lite] ($3/月) または [GLM Coding Pro] ($15/月) を選択する。
# クレジットカード情報を入力して契約を完了する。
<br>
==== ステップ 2 : APIキーの取得 ====
Z.aiダッシュボードにアクセスしてAPIキーを取得する。<br>
* https://z.ai/model-api
<br>
APIキー取得手順を以下に示す。<br>
# ダッシュボードにログインする。
# メニューから [API Keys] セクションを開く。
# [+ Create a new API key] を選択する。
# 識別用の名前 (例: Cline用) を入力する。
# 生成されたAPIキーをコピーして安全な場所に保存する。
#: APIキーは1度しか表示されないため、必ず保存すること。
<br><br>

== ClineでZ.aiを設定する手順 ==
==== ステップ 1 : Cline拡張機能のインストール ====
VS CodeにCline拡張機能をインストールする。<br>
<br>
# VS Codeを起動して、左サイドバーの拡張機能アイコンを選択する。
# 検索バーに <u>Cline</u> と入力する。
# [Cline] を見つけて [Install] を選択する。
<br>
==== ステップ 2 : Z.ai API Providerの設定 ====
ClineにZ.aiのAPIキーを設定する。<br>
<br>
# VS Code左サイドバーに追加されたClineアイコンを選択する。
# 右上の歯車アイコン (Settings) を選択する。
# [API Provider] ドロップダウンメニューから [Z AI] を選択する。
# [Entrypoint] ドロップダウンで以下のいずれかを選択する。
#* International Standard (api.z.ai)
#*: 海外 (日本含む) からのアクセス用
#* China Standard (open.bigmodel.cn)
#*: 中国国内からのアクセス用
# [Z AI API Key] フィールドにAPIキーを貼り付ける。
# [Model] ドロップダウンから [glm-4.7] を選択する。
<br>
==== ステップ 3 : Coding Plan用エンドポイントに関する注意点 ====
ClineのZ.ai設定画面にGLM Coding Plan専用のエンドポイント (<u>/api/coding/paas/v4</u>) が選択肢として表示されない場合がある。<br>
対処法を以下に示す。<br>
<br>
===== 方法A : 標準APIエンドポイントをそのまま使用 =====
Coding Planに登録したAPIキーを使用すれば、自動的にサブスクリプションのクォータが適用される場合がある。<br>
まずはこの方法で試すことを推奨する。<br>
<br>
===== 方法B : OpenAI Compatible設定を使用 =====
Coding Planのエンドポイントを明示的に指定する場合は、以下に示す設定を行う。<br>
<br>
 API Provider: OpenAI Compatible
 Base URL: https://api.z.ai/api/coding/paas/v4
 API Key: [Z.ai APIキー]
 Model ID: glm-4.7
<br>
===== 方法C : Clineの最新版を確認 =====
Clineは頻繁に更新されている。<br>
拡張機能を最新版に更新することで、Coding Plan用のエンドポイントがサポートされている可能性がある。<br>
<br><br>

== ルール (.clinerules) の作成手順 ==
ルールはプロジェクト固有の指示をClineに与えるもので、コーディング規約やプロジェクト構造の強制に使用する。<br>
<br>
==== 単一ファイル形式での作成 ====
プロジェクトのルートディレクトリに <u>.clinerules</u> ファイルを作成する。<br>
 vi .clinerules
<br>
例えば、組み込み・デスクトップアプリ開発向けの.clinerulesファイルの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # 言語とコミュニケーション
 - すべての応答とコメントは日本語で記述すること
 - コードのコメントは日本語でわかりやすく書くこと
 - 技術用語は必要に応じて英語を併記すること
 
 # コーディング規約 (C++)
 - C++17以降の規格に準拠すること
 - スマートポインタ (std::unique_ptr, std::shared_ptr) を優先的に使用
 - 生ポインタは所有権を持たない観察用途のみで使用
 - 例外処理よりもエラーコード返却を優先 (組み込み向け)
 
 # 命名規則
 - ローカル変数: camelCase (例: localVariable)
 - メンバ変数: m_付きcamelCase (例: m_memberVariable)
 - 定数・マクロ: ALL_CAPS (例: MAX_BUFFER_SIZE)
 - クラス名: PascalCase (例: DataProcessor)
 - 名前空間: lowercase (例: myproject::utils)
 
 # Qt開発固有ルール
 - Qt6を標準として使用すること
 - シグナル・スロット接続は新しい構文を使用:
   connect(sender, &Sender::signal, receiver, &Receiver::slot);
 - QObjectの親子関係を活用し、メモリ管理を簡素化すること
 
 # 組み込み開発固有ルール
 - MSP430/MSP432向けコードではヒープ使用を最小限に
 - 割り込みハンドラは短く保つこと
 - volatile修飾子を適切に使用すること
 
 # ドキュメント
 - 関数にはDoxygenスタイルのコメントを付けること
 - READMEやドキュメントは私が指示するまで編集しないこと
 
 # テスト
 - コード生成後は単体テストコードも生成すること
 - テストフレームワークはGoogle Testを使用すること
 
 # ファイル操作
 - 編集するファイルは提案のみ行い、確認を求めること
 - ランダムにファイルを開かず、編集対象を明示すること
 </syntaxhighlight>
<br>
==== フォルダ形式での管理 ====
複数のルールファイルを使い分ける場合は、<u>.clinerules/</u> フォルダを作成する。<br>
<br>
 プロジェクトルート/
 ├── .clinerules/
 │   ├── general.md          # 全般的なルール
 │   ├── cpp-rules.md        # C++固有のルール
 │   ├── qt-rules.md         # Qt固有のルール
 │   ├── embedded-rules.md   # 組み込み開発ルール
 │   ├── fpga-rules.md       # FPGA/Verilogルール
 │   └── documentation.md    # 仕様書作成ルール
 └── src/
     └── ...
<br>
embedded-rules.mdファイルの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # 組み込み開発ルール
 
 ## 対象マイコン
 - TI: MSP430, MSP432, MSPM0
 - ATMEL: ATmega168, ATmega328, ATmega1284
 
 ## メモリ管理
 - 動的メモリ確保 (malloc/new) は原則禁止
 - スタックサイズを意識した変数配置
 - 大きな配列はstatic修飾子を付けてBSSセクションに配置
 
 ## 割り込み処理
 - 割り込みハンドラは最小限の処理のみ
 - フラグを立てて、メインループで処理するパターンを推奨
 - volatile修飾子を忘れずに付与
 
 ## 低消費電力設計
 - 不要なペリフェラルはクロック停止
 - 適切なスリープモードの使用
 - ウェイクアップ条件の明確化
 
 ## レジスタ操作
 - ビットフィールド操作にはマクロを使用
 - マジックナンバーは定義済み定数で置き換え
 </syntaxhighlight>
<br>
fpga-rules.mdファイルの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # FPGA/Verilog-HDL開発ルール
 
 ## 対象デバイス
 - Xilinx FPGA (Vivado対応)
 
 ## コーディング規約
 - 同期設計を基本とする
 - 非同期リセットは避け、同期リセットを使用
 - always_ff / always_comb を使用 (SystemVerilog)
 
 ## 命名規則
 - 信号名: snake_case (例: data_valid)
 - パラメータ: ALL_CAPS (例: DATA_WIDTH)
 - モジュール名: PascalCase (例: DataProcessor)
 - クロック信号: clk_xxx
 - リセット信号: rst_n (負論理)
 
 ## テストベンチ
 - 各モジュールにテストベンチを作成
 - 期待値との自動比較を実装
 - カバレッジを意識した入力パターン
 
 ## タイミング制約
 - セットアップ/ホールド違反に注意
 - クロックドメイン間はCDC対策を実施
 </syntaxhighlight>
<br>
==== ルールの有効化と切り替え ====
Clineはプロジェクトを開くと自動的に <u>.clinerules</u> ファイルを読み込む。<br>
Cline v3.0以降では、各ルールファイルの有効 / 無効をUIから切り替えることができる。<br>
<br>
# ClineのサイドパネルでRulesアイコンを選択する。
# 現在有効なルールの一覧が表示される。
# 各ルールファイルの横にあるトグルで有効 / 無効を切り替える。
<br><br>

== スキル (Custom Instructions) の作成手順 ==
スキルはVS Code全体に適用されるグローバルな指示で、個人の作業スタイルや専門分野を反映させる。<br>
<br>
==== Custom Instructionsの設定画面を開く ====
# VS CodeでサイドバーのClineアイコンを選択する。
# 歯車アイコン (Settings) を選択する。
# [Custom Instructions] のテキストエリアを探す。
<br>
==== Custom Instructionsの記述例 ====
組み込み・デスクトップアプリケーション開発向けのCustom Instructions記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # 基本指示
 常に日本語で応答してください。
 技術用語は必要に応じて英語を併記してください。
 
 # 私のバックグラウンド
 - 組み込みシステム開発 (TI MSP430/MSP432/MSPM0、ATMEL ATmega) の実務経験あり
 - デスクトップアプリケーション開発 (C#/WindowsForms、C#/Avalonia UI、C#/Photino.Blazor、QML/C++、Qt Widgets/C++、Rust/Tauri/React) を行う
 - FPGA開発 (Xilinx、Verilog-HDL) の知識がある
 - アナログ/デジタル混載回路設計を行う
 - KiCADでの基板設計を行う
 - MATLABでのスクリプト開発を行う
 
 # コード生成時の注意
 - 組み込みシステムのコードでは、メモリ使用量を最小限に抑えること
 - リソース制約のあるターゲット (MSP430等) ではヒープ使用を避けること
 - Qt開発ではQt6を標準として使用すること
 - エラーハンドリングを必ず含めること
 - コードには日本語でコメントを付けること
 
 # 仕様書作成時の注意
 - 画面定義書、機能概要書はEXCEL向けの構造化データで出力
 - 画面遷移図、DFD、フローチャート、ER図はDraw.io形式を提案
 - シーケンス図、状態遷移図、タイミングチャートはMermaid記法で出力
 - 単体試験書はEXCEL向けの構造化データで出力
 
 # 品質基準
 - 生成するコードには必ずコメントを付けること
 - 複雑なロジックには図解やダイアグラムの提案をすること
 - 変数名・関数名は意味のある名前を付けること
 </syntaxhighlight>
<br>
==== 用途別のCustom Instructionsテンプレート ====
===== 仕様書作成支援向け =====
 <syntaxhighlight lang="md">
 # 仕様書作成モード
 - EXCEL形式を想定した構造化データを提供すること
 - Draw.io XML、Mermaid記法に対応すること
 - テーブル定義はデータ型、制約、インデックスを漏れなく記載すること
 
 # 出力フォーマット
 - シーケンス図/タイミングチャート: Mermaid
 - フローチャート/ER図: Draw.io互換
 - データフロー図: 入出力型情報を含む
 </syntaxhighlight>
<br>
===== ハードウェア開発向け =====
 <syntaxhighlight lang="md">
 # 回路設計・基板設計モード
 - KiCADシンボル/フットプリント命名規則に準拠すること
 - デザインルールはJLCPCB等の製造制約を考慮すること
 - 部品選定では入手性と代替品情報を提供すること
 
 # FPGA開発
 - Verilog-HDLはXilinxコーディングガイドラインに準拠すること
 - テストベンチを必須で生成すること
 - タイミング制約の考慮事項を明記すること
 </syntaxhighlight>
<br><br>

== サブエージェント相当機能の実現方法 ==
例えば、Claude Codeにはサブエージェントという機能があり、特定のタスクに特化したAIアシスタントを定義して親エージェントと子エージェントに分けて推論させることができる。<br>
しかし、Clineにはネイティブでこれと同等の機能は存在しない。<br>
<br>
Clineでサブエージェント相当の機能を実現するには、sub-agents-mcp等のMCPサーバを利用する方法がある。<br>
<br>
==== Claude Codeのサブエージェントとは ====
Claude Codeのサブエージェントは、YAMLフロントマターを持つMarkdownファイルとして定義され、以下の特徴を持つ。<br>
* 独立したコンテキストウィンドウ (各エージェントが1Mトークン) を持つ。
* カスタムシステムプロンプトによる専門化が可能
* 特定のツール (Read、Write、Edit、Bash等) へのアクセス制限が可能
* 異なるモデル (Opus、Sonnet、Haiku等) の使用が可能
* <u>.claude/agents/</u> または <u>~/.claude/agents/</u> に配置される。
<br>
==== MCPサーバとは ====
MCP (Model Context Protocol) サーバは、外部APIやサービスとの連携を提供するプロトコルベースの拡張機能である。<br>
これはClineに限らず、Claude Code等でも使用される汎用的な機能拡張の仕組みである。<br>
<br>
MCPサーバの主な用途を以下に示す。<br>
* 外部APIの呼び出し (GitHub、Jira、AWS等)
* ファイル処理の自動化
* データベースへのアクセス
* 特定ドメインの知識検索
<br>
==== Clineでサブエージェント相当機能を実現する方法 ====
Clineでサブエージェント相当の機能を実現するには、sub-agents-mcpというMCPサーバを利用する。<br>
このMCPサーバを使用することで、Claude Code形式のサブエージェント定義ファイルをClineでも活用できるようになる。<br>
<br>
===== ステップ 1 : エージェント定義フォルダの作成 =====
エージェント定義ファイルを格納するフォルダを作成する。<br>
 mkdir -p ~/cline-agents
<br>
===== ステップ 2 : エージェント定義ファイルの作成 =====
エージェント定義ファイルはMarkdown形式で作成する。<br>
<br>
code-reviewer.md (コードレビュー用) の記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # Code Reviewer
 
 あなたはコードレビューに特化したAIアシスタントです。
 
 ## 責務
 - バグや潜在的な問題の発見
 - コード品質の改善提案
 - セキュリティ上の脆弱性チェック
 - パフォーマンス最適化の提案
 
 ## レビュー観点
 - C++コードではメモリリーク、ダングリングポインタに注意
 - Qtコードではシグナル・スロットの接続漏れを確認
 - 組み込みコードではスタックオーバーフローリスクを確認
 - 例外処理・エラーハンドリングの有無を確認
 - コーディング規約への準拠を確認
 
 ## 出力フォーマット
 レビュー結果は以下の形式で出力:
 1. 重大な問題 (修正必須)
 2. 中程度の問題 (修正推奨)
 3. 軽微な問題 (改善提案)
 4. 良い点 (コメント)
 </syntaxhighlight>
<br>
spec-writer.md (仕様書作成用) の記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # 仕様書作成エージェント
 
 あなたはソースコードから技術仕様書を作成するエキスパートです。
 
 ## 出力対象
 - 機能概要書
 - 画面定義書
 - インターフェース仕様書
 - データベーステーブル定義書
 
 ## 出力フォーマット
 - EXCEL向け: CSV形式またはタブ区切りで構造化
 - Draw.io向け: XMLまたはフローチャート記述
 - Mermaid向け: シーケンス図、状態遷移図
 
 ## 抽出する情報
 1. 関数一覧: 関数名、引数、戻り値、概要
 2. クラス構造: クラス名、メンバ変数、メソッド
 3. データフロー: 入力、処理、出力
 4. エラー処理: エラーコード、対処方法
 </syntaxhighlight>
<br>
circuit-analyzer.md (回路解析用) の記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # 回路解析エージェント
 
 あなたは電子回路設計のエキスパートです。
 
 ## 専門分野
 - アナログ/デジタル混載回路
 - 電源回路設計
 - EMC対策
 - 熱設計
 
 ## 解析項目
 1. 回路図のレビュー
 2. 部品選定の妥当性確認
 3. 熱設計の検討
 4. ノイズ対策の提案
 
 ## 出力フォーマット
 - KiCADシンボル/フットプリント名の提案
 - 代替部品リスト (LCSC番号付き)
 - 設計上の注意点リスト
 - BOM (部品表) の雛形
 </syntaxhighlight>
<br>
===== ステップ 3 : sub-agents-mcp の設定 =====
VS Codeの settings.json に sub-agents-mcp の設定を追加する。<br>
<br>
# VS Codeで [Ctrl] + [Shift] + [P]キーを同時押下してコマンドパレットを開く。
# [Preferences: Open Settings (JSON)] を選択する。
# 以下の設定を追加する。
#: <syntaxhighlight lang="json">
 {
   "cline.mcpServers": {
     "sub-agents": {
       "command": "npx",
       "args": ["-y", "sub-agents-mcp"],
       "env": {
         "AGENTS_DIR": "/home/yourname/cline-agents",
         "AGENT_TYPE": "cursor",
         "EXECUTION_TIMEOUT_MS": "600000"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
環境変数の説明を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ sub-agents-mcpの環境変数
! 環境変数 !! 説明
|-
| AGENTS_DIR || エージェント定義ファイルを格納するディレクトリのパス
|-
| AGENT_TYPE || エージェントタイプの指定 (cursor を推奨)
|-
| EXECUTION_TIMEOUT_MS || 実行タイムアウト時間 (ミリ秒)
|}
</center>
<br>
===== ステップ 4 : サブエージェントの呼び出し =====
Clineで以下に示すように指示することで、定義したエージェントを呼び出すことができる。<br>
<br>
 code-reviewerサブエージェントで src/main.cpp をレビューして
<br>
 spec-writerエージェントを使用して、このプロジェクトの機能概要書を作成して
<br>
==== MCPサーバの簡単な追加方法 ====
Clineには、チャットで指示するだけでMCPサーバを自動作成・インストールする機能がある。<br>
<br>
GitHub連携ツールの追加例を以下に示す。<br>
 add a tool that fetches GitHub issues and creates pull requests
<br>
ファイル変換ツールの追加例を以下に示す。<br>
 add a tool that converts markdown files to structured data for Excel
<br>
Clineはこの指示を受けて、適切なMCPサーバの作成、インストール、設定を自動で行う。<br>
<br>
==== Claude CodeとClineの機能比較 ====
Claude CodeとClineの機能の対応関係を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ Claude CodeとClineの機能対応表
! Claude Code !! Cline !! 備考
|-
| サブエージェント || ネイティブでは同等機能なし || sub-agents-mcp等のMCPサーバを使用して類似機能を実現可能
|-
| スキル || Custom Instructions || 概ね同等の機能
|-
| ルール || .clinerules || 概ね同等の機能
|-
| MCP Server || MCP Server || 同等の機能
|}
</center>
<br><br>

== Z.ai MCPサーバの活用 ==
Z.ai GLM Coding Planには、以下のMCPサーバが付属している。<br>
<br>
<center>
{| class="wikitable"
|+ Z.ai付属MCPサーバ一覧
! MCPサーバ !! 機能
|-
| Vision Understanding MCP || 画像・スクリーンショットの解析
|-
| Web Search MCP || リアルタイムWeb検索
|-
| Web Reader MCP || Webページの内容取得・解析
|}
</center>
<br>
これらはCoding Planに含まれているため、追加料金なしで利用できる。<br>
<br><br>

== GLMシリーズのモデル一覧 ==
Z.aiが提供するGLMシリーズの主要モデルを以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ GLMシリーズ主要モデル一覧
! モデル名 !! タイプ !! コンテキスト !! 主な用途 !! 提供形態
|-
| GLM-4-9B || 汎用 || 128K || 一般用途 || オープンウェイト
|-
| GLM-4-32B || 汎用 || 128K || 高性能汎用 || オープンウェイト
|-
| GLM-4.5 || MoE || - || 高効率推論 || API / オープンウェイト
|-
| GLM-4.6V || マルチモーダル || 128K || 画像・動画・文書理解 || オープンウェイト
|-
| GLM-4.7 || コーディング特化 || 200K || コーディング・推論 || API / オープンウェイト
|-
| GLM-5 || MoE (744B) || 200K || フロンティアタスク || オープンウェイト (MIT)
|}
</center>
<br>
各モデルはOllama、Hugging Face、Fireworks、Novita等のプラットフォームでも利用可能である。<br>
<br><br>

== 構成例 ==
プロジェクトの推奨構成を以下に示す。<br>
<br>
 プロジェクト/
 ├── .clinerules/
 │   ├── general.md           # 日本語対応、基本ルール
 │   ├── cpp-qt-rules.md      # C++/Qt開発ルール
 │   ├── embedded-rules.md    # 組み込み開発ルール
 │   ├── fpga-rules.md        # FPGA/Verilog開発ルール
 │   └── documentation.md     # 仕様書作成ルール
 │
 ├── ~/cline-agents/           # サブエージェント相当の定義ファイル (sub-agents-mcp用)
 │   ├── code-reviewer.md     # コードレビュー用エージェント
 │   ├── spec-writer.md       # 仕様書作成用エージェント
 │   ├── test-generator.md    # テスト生成用エージェント
 │   └── circuit-analyzer.md  # 回路解析用エージェント
 │
 └── .vscode/
      └── settings.json        # Cline設定 (API Provider、Model、Custom Instructions、MCP Servers)
<br>
<center>
{| class="wikitable"
|+ 機能別の用途と保存場所
! 機能 !! 用途 !! 保存場所
|-
| ルール (.clinerules) || プロジェクト固有規約・制約 || プロジェクトルート
|-
| スキル (Custom Instructions) || 個人専門性・作業スタイル || VS Code設定
|-
| サブエージェント相当 (sub-agents-mcp) || 特定タスクに特化したAIアシスタント || ~/cline-agents/
|-
| MCPサーバ || 外部API連携・機能拡張 || VS Code settings.json
|}
</center>
<br>
推奨運用フローを以下に示す。<br>
# Custom Instructionsでグローバル専門性を定義する。(1度だけの設定)
# プロジェクトごとの .clinerules を管理する。(Git管理可能)
# 必要に応じて sub-agents-mcp を設定し、特定タスク向けのエージェント定義ファイルを作成する。
# 外部サービス連携が必要な場合は、適切なMCPサーバを追加する。
<br>
<u>※注意</u><br>
<u>sub-agents-mcpを使用したサブエージェント相当機能は、Claude Codeのネイティブサブエージェント機能と比較して以下の点が異なる。</u><br>
* Claude Codeのサブエージェントは各エージェントが独立した200Kトークンのコンテキストウィンドウを持つが、sub-agents-mcpではこの機能は限定的である
* Claude Codeではツールアクセス制限 (Read、Write、Edit、Bash等) を細かく設定できるが、sub-agents-mcpでは同等の制御は困難である
* Claude Codeではサブエージェントごとに異なるモデル (Opus、Sonnet、Haiku等) を指定できるが、sub-agents-mcpでは対応状況が異なる
<br>
本格的なサブエージェント機能が必要な場合は、Claude Codeの使用を検討することを推奨する。<br>
<br><br>

== トラブルシューティング ==
==== Coding Planのクォータが消費されない / 従量課金されている ====
エンドポイントが正しく設定されていない可能性がある。<br>
<br>
確認事項を以下に示す。<br>
# Clineを最新版に更新する。
# Z.aiダッシュボードでCoding Planの契約状況を確認する。
# 必要に応じてOpenAI Compatible設定でエンドポイントを明示的に指定する。
<br>
==== APIキーが無効と表示される ====
確認事項を以下に示す。<br>
# APIキーをコピーする際に余分な空白が含まれていないか確認する。
# APIキーがCoding Plan用のものか確認する。(通常API用とは異なる場合がある)
# Z.aiダッシュボードでAPIキーのステータスを確認する。
<br>
==== 日本語の応答にならない ====
Custom Instructionsに「常に日本語で応答してください」を追加、あるいは、.clinerulesファイルに同様の指示を記載する。<br>
<br>
==== サブエージェントが動作しない ====
===== 設定ファイルの確認 =====
サブエージェントの定義ファイルが正しい場所に配置されているか確認する。<br>
<br>
* プロジェクトレベル
*: .claude/agents/
* ユーザレベル
*: ~/.claude/agents/
<br>
===== MCPサーバの確認 =====
VS Codeのsettings.jsonファイルでMCPサーバが正しく設定されているか確認する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "cline.mcpServers": {
     "sub-agents": {
       "command": "npx",
       "args": ["-y", "sub-agents-mcp"],
       "env": {
         "AGENTS_DIR": "/path/to/your/agents"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
===== VS Codeの再起動 =====
設定を変更した後、VS Codeを再起動することで設定が反映される。<br>
<br><br>

== 参考リンク ==
* [https://z.ai/ Z.ai 公式サイト]
* [https://z.ai/subscribe Z.ai GLM Coding Plan]
* [https://z.ai/model-api Z.ai Model API]
* [https://z.ai/blog/glm-4.7 GLM-4.7: Advancing the Coding Capability]
* [https://docs.z.ai/devpack/overview Z.ai Developer Document - Overview]
* [https://docs.cline.bot/provider-config/zai Cline Documentation - Z AI]
* [https://github.com/cline/cline Cline GitHub]
* [https://github.com/THUDM/GLM GLM - GitHub (THUDM)]
* [https://github.com/zai-org/GLM-4 GLM-4 Series - GitHub]
* [https://arxiv.org/abs/2103.10360 GLM: General Language Model Pretraining with Autoregressive Blank Infilling (論文)]
* [https://ollama.com/library/glm-4.7 GLM-4.7 - Ollama]
* [https://huggingface.co/zai-org Hugging Face - Z.ai Organization]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Cline,Z.ai,GLM-4.7,GLM-5,GLM,Zhipu AI,智譜AI,VS Code,AI,Development,Programming,MCP,Custom Instructions,大規模言語モデル
|description={{PAGENAME}} - GLMシリーズとVS Code ClineとZ.ai GLMの設定手順
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]