Communitygithub.com

Glyph AI

Glyphは、今日のインテリジェンスを構成する形式を作成し、明日の言語を発見するためのワークベンチです。

Glyph AI とは?

このスキルは、GlyphサーバーのCLIをAIエージェント(Claude Code、Cursor、Codexなど)から制御するための完全な操作マップです。`glyph`コマンドの全サブコマンド(workspace、session、task、schedule、catalog、workflow、runtime、server inspection)をカバーし、特にワークスペーススコープの規律とエラーコードに基づく分岐処理に重点を置いています。環境変数`GLYPH_SERVER`と`GLYPH_WORKSPACE`を利用して、他のクライアントと競合しない安全な操作を実現します。JSON出力パース、ストリーミングフォロー、エラーハンドリング、終了コードの解釈など、生産性を最大化するための実践的なパターンを提供します。このスキールは、タスクのディスパッチ、ワークフローの管理、カタログからのエージェントインストールなど、複雑なマルチステップ操作をエラーリカバリを含めて自動化するのに最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add glyphs-ai/glyph

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

official/cli スキル

あなたは、CLIを通じてGlyphサーバーを制御するAIです。このスキルは、glyphコマンドの全表面と、--helpからはわかりにくい規則(特に、他のクライアントとの競合を防ぐワークスペーススコープの規律、および障害時に機械的に分岐するための終了コード/エラーコードの規律)の地図です。

セットアップ

glyph は、タスクまたはセッションを起動するときに、必要なものを環境に注入します。

  • GLYPH_SERVER — サーバーURL(CLIはこれを自動的に使用します)
  • GLYPH_WORKSPACE — ワークスペースUUID(ワークスペーススコープのコマンドはこれを継承します)

クイック確認:

glyph health        # 終了コード0 ⇒ CLIが動作し、サーバーに到達可能
glyph workspace current --json | jq   # ワークスペースが解決されたことを確認

コマンド表面の概要

ワークスペーススコープのすべてのコマンドは --server / --workspace-id / --output / --json を継承し、以下の共通終了コードテーブルに従います。サブコマンドグループ:

グループ目的参照
workspaceワークスペースの作成/一覧表示/表示/更新/削除/リロード、現在のIDの表示references/commands.md#workspace
sessionインタラクティブセッションの管理(一覧表示/新規作成/表示/削除/端末の起動)references/commands.md#session
taskワンショットタスクのディスパッチ、一覧表示(--origin によるスコープ指定を含む)、検査、アクティビティの追跡、キャンセル、削除references/commands.md#task
scheduleCronトリガータスクランチャー(作成/一覧表示/パッチ/有効化/無効化/実行/プレビュー/タスク一覧表示)references/commands.md#schedule
catalogエージェント、スキル、MCPのインストール/同期/有効化/無効化references/commands.md#catalog
workflowワークフローのシード、ライブDAGの読み取り/変更(展開、update-spec による未開始ノードの仕様パッチ)、人間ノードへの応答、終了references/commands.md#workflow
runtime登録済みランタイムの一覧表示(copilotなど)references/commands.md#runtime
サーバー検査health, config, status, logs — ライフサイクルなしreferences/commands.md#server-inspection
サーバーライフサイクルserve / start / stop / restart — このスキルの範囲外—

ワークスペースの規律

ワークスペーススコープのすべてのコマンドには、明示的なセレクターが必要です。CLIは環境から GLYPH_WORKSPACE を読み取ります(既に設定されています)。そのため、コマンドはそのまま動作します:

glyph task dispatch --agent writer --brief "..."

別のワークスペースで操作するには、コマンドごとに --workspace-id <id> を渡します:

glyph task list --workspace-id ws-Y

CLIは、サーバー側の共有「現在のワークスペース」状態を参照しません。セレクターはプロセスローカルであり、他のクライアント(他のCLIセッション、ダッシュボードタブ、同じサーバー上のAIエージェント)からの干渉を受けません。

出力の規律

  • 解析用には、常に --json を渡してください。 人間向け/テーブル形式は安定した契約ではありません。列の順序や見出しはリリース間で変更されます。
  • アクティビティのストリーミングには、jq -c にパイプして 1イベントを1行に保ちます。
  • 消費する可能性が高いすべての --json 形状は references/json-shapes.md に文書化されています。jq フィルターを記述する前に参照してください。ほとんどの形状にはオプションフィールド(対応する行がnullでない場合に存在する)があり、それを利用する必要があります。

エラーの規律

エラーはstderrに常に code を伴います:

agent "writer" is not ready: prereqs not acknowledged (HTTP 409, EntryNotReadyError)
  agent: acme/writer
  cause: prereqs not acknowledged
  fix:   glyph catalog agent ack-prereqs acme/writer

fix: 行は、次のコマンドそのものです。完全な code カタログ(すべてのエラー名 + 典型的なHTTP + 修復方法)は references/error-codes.md にあります。特に:

  • EntryNotReadyError は、最も頻繁に遭遇する分岐です。エージェントが ack-prereqs を必要とするか、disabled であるか、missingDeps があるか、blockedDeps(再帰的)があるかを説明する構造化された reason を伴います。理由テーブルは references/error-codes.md#entrynotreadyerror-reasons にあります。

終了コード

コード意味対処方法
0成功続行
1一般的なエラー(ワークスペース欠落を含む)stderrを読む。通常はフラグ/envの欠落
2使用法エラー(必須フラグの欠落、削除されたサブコマンド)呼び出しを修正。そのまま再試行しないでください
3サーバーに到達不可ユーザーに glyph start または --server の確認を依頼
4サーバーが4xx/5xxを返したstderrの code を読み、references/error-codes.md を参照

終了コード2は 「コマンド自体が間違っている」 ことを意味します。呼び出しを変更せずに再試行しないでください。終了コード4は「サーバーがこれを拒否した」ことを意味します。code フィールドを読むと、次のアクションがわかります。

落とし穴

  • タスクを待つには、glyph task activity <tid> --follow を使用してください(リアルタイムSSE)。シェルループで task list をポーリングすると、サイクルを無駄にし、実際のイベントに遅れます。
  • 「これまでの経過」のワンショットスナップショットには、--follow を削除してください — glyph task activity <tid> --json は、1回の呼び出しで現在のアクティビティと totalItems を返します。--follow はタスクが終了するまでブロックします。
  • 削除する前に終了させてください。 単純な task rm <tid> は、タスクが終了状態(succeeded / failed / cancelled)である必要があります。まだ実行中の場合は、最初に glyph task cancel <tid> を実行し、次に task rm を実行します。--purge は、ワークディレクトリとランタイム状態も削除したい場合にのみ使用してください(事後分析用の stderr.log は失われます)。session rm と workspace rm でも同じ区別があります。
  • --follow は、常に表示された last seq: で再開してください。 クリーン終了(event: end またはストリームクローズ)時と、ストリーム途中のエラー終了時の両方で、CLIは stderr に last seq: <N> を出力します。次の --follow 呼び出しで --after <N> を渡すと、ギャップや重複なく再開できます。Ctrl+Cは例外です(stderrがフラッシュされません)。代わりに、最後の stdout NDJSON アイテムからシーケンス番号を取得します(... | tail -1 | jq .seq)。完全な再開プレイブックは references/playbooks.md#monitor-a-long-running-task にあります。
  • ワークスペースIDは常に glyph workspace list --json | jq から取得してください。 ダッシュボードのURLフラグメントはリリース間で変化するため、ワイヤー契約として使用できません。
  • schedule patch はスパースです — 渡したフラグのみがワイヤーを経由します。フィールドを削除するには、--clear-details / --clear-runtime を渡します(空の --details "" は省略とみなされ、クリアとしては扱われません)。

参考文献(重要な作業の前に必読)

  • references/commands.md — グループごとのサブコマンドリファレンス(workspace / session / task / schedule / catalog / workflow / runtime / server inspection)。一度ざっと読み、参照用に保持してください。
  • references/playbooks.md — マルチステップの目標指向プレイブック(エージェントのインストールと確認、ディスパッチと待機、タスクの監視、エントリの同期、クリーンアップ、新しいワークスペースのオンボード、ローカルエージェントの即席作成)。
  • references/json-shapes.md — 一般的な --json ペイロード形状と、具体的なフィールドリストおよびオプション性の注記。
  • references/error-codes.md — サーバーが発行するすべての code 値と、それを修正するための対応する glyph コマンド。

関連スキル