mcpField
C
chatcrystal-debug-recall

chatcrystal-debug-recall

github.com/zengliangyiエージェントワークフロー6153 回インストール5 日前に更新
リポジトリ

chatcrystal-debug-recall について

ChatCrystal Coreを使うエージェント向けのデバッグスキルです。診断前に関連するプロジェクトメモリーを検索し、利用できない場合もデバッグを続けます。

主な機能

  1. 01デバッグタスクの検出
  2. 02タスクに応じたメモリー検索
  3. 03原因と修正策を優先
  4. 04検索不可でも作業を継続

活用シーン

  1. 01テスト失敗の調査
  2. 02実行時例外の診断
  3. 03依存関係や環境問題の調査

MCP 対応

利用可能な場合、ChatCrystal CoreのMCPツール `recall_for_task` でデバッグメモリーを取得します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zengliangyi/chatcrystal --skill chatcrystal-debug-recall

インストール後、Claude Code で/chatcrystal-debug-recallを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

ChatCrystal のデバッグ想起

タスクが明らかに診断やデバッグに関する場合は、このスキルを使用してください。このスキルは簡潔に保ち、検索は ChatCrystal Core に任せてください。

ワークフロー

  1. タスクにテストの失敗、コンパイラーエラー、実行時例外、依存関係の破損、環境の問題、またはパフォーマンスの低下が含まれる場合に起動します。
  2. recall_for_task が利用可能な場合は、修正を提案する前に次の内容を指定して呼び出します。
    • mode: "debug"
    • task.goal:具体的なデバッグの目的
    • task.task_kind: "debug"
    • 分かっている場合は task.project_dir と task.cwd
    • 分かっている場合は task.branch
    • 分かっている場合は task.related_files または task.files_touched
    • 利用できる最も有用な識別情報を設定した task.error_signatures
  3. 次のような具体的なシグナルを優先します。
    • 失敗したテスト名
    • 例外クラス
    • エラーコード
    • ログのシグネチャ
    • 障害に実質的な影響を与える場合のパッケージまたはツールのバージョン
  4. 根本原因、修正方法、または既知の落とし穴を説明する、返されたメモリーを優先します。
  5. 想起したメモリーは診断の精度を高めるために使用し、現在の環境での検証を省略するために使用しないでください。

MCP 入力の例

デバッグ用に recall_for_task を呼び出す際は、次の形式を使用します。

{
  "mode": "debug",
  "task": {
    "goal": "Diagnose failing build after TypeScript upgrade",
    "task_kind": "debug",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "upgrade/typescript",
    "related_files": [
      "server/src/cli/mcp/server.ts",
      "tsconfig.base.json"
    ],
    "error_signatures": [
      "TS2322",
      "Type is not assignable"
    ],
    "source_agent": "codex"
  },
  "options": {
    "project_limit": 5,
    "global_limit": 3,
    "include_relations": true
  }
}

フルモード

フルモードには ChatCrystal Core と、recall_for_task への MCP アクセスが必要です。

  • project_memories を主として扱い、global_memories は補助的に扱います。
  • 応答に警告や no-matches が含まれる場合も、通常どおりデバッグを続けてください。
  • 現在の障害シグネチャが大きく異なる場合は、想起した修正に過度に依存しないでください。

制限モード

ChatCrystal Core または MCP ツールが利用できない場合:

  • デバッグタスクを中断せずに続行してください。
  • 長期的なデバッグ想起を利用できないことを簡潔に伝えてください。
  • 過去の障害、原因、修正を捏造しないでください。
  • インストールコマンドをスキルの自動ステップにしないでください。

コメント