mcpField
C
chatcrystal-task-recall

chatcrystal-task-recall

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

chatcrystal-task-recall について

ChatCrystal Core 向けの作業前リコールワークフローです。実装、リファクタリング、移行、設定、調査、最適化などの重要な作業を対象とし、プロジェクトの記憶を優先します。Core や MCP ツールが使えない場合も作業を続けられます。

主な機能

  1. 01リコールが必要な作業を判定
  2. 02作業目標とコンテキストを送信
  3. 03プロジェクトの記憶を優先
  4. 04Core やツールがなくても続行

活用シーン

  1. 01実装やリファクタリング前に関連経験を参照
  2. 02調査前にプロジェクトの決定や注意点を確認

MCP 対応

完全なワークフローには ChatCrystal Core と MCP ツール recall_for_task が必要です。作業コンテキストの渡し方と、返されたプロジェクトの記憶の扱い方を示します。

インストール

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

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

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

同梱ファイルagents/openai.yaml

詳細

ChatCrystal Task Recall

このスキルは、ChatCrystal Core の上に軽量なワークフローとして使用します。このスキル内に別のメモリシステムを作らないでください。

ワークフロー

  1. タスクがリコールを行うに足る規模かどうかを判断します。
  2. 重要度の高い implement、refactor、migration、config、investigate、または optimization の作業では実行します。
  3. 軽微な編集、一行で済む回答、または純粋に会話を目的とするリクエストでは実行しません。
  4. recall_for_task が利用可能な場合、重要な作業に着手する前に、次の内容で呼び出します。
    • mode: "task"
    • task.goal:具体的なタスクの目的
    • task.task_kind:最も適切なタスクの種類
    • リポジトリのコンテキストがある場合は task.project_dir と task.cwd
    • 判明している場合は task.branch
    • 判明している場合は task.related_files または task.files_touched
    • 実行環境に安定した値がある場合は task.source_agent
  5. project_memories を主なコンテキストとして扱い、global_memories は補足情報として扱います。
  6. リコールした注意点、パターン、過去の決定事項を、コードの提案や作成に先立って適用します。

MCP 入力例

実装または調査の作業で recall_for_task を呼び出す際は、次の形式を使用します。

{
  "mode": "task",
  "task": {
    "goal": "Add a paginated notes export endpoint",
    "task_kind": "implement",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "feature/export-notes",
    "related_files": [
      "server/src/routes/notes.ts",
      "shared/types/index.ts"
    ],
    "source_agent": "codex"
  },
  "options": {
    "project_limit": 5,
    "global_limit": 3,
    "include_relations": true
  }
}

フルモード

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

  • Core が project_key を導出できるよう、現在のリポジトリまたはワークスペースのパスを優先します。
  • no-project-key や no-matches などの関連する警告を提示しますが、エラーとして扱わないでください。
  • リコールで有用な情報が得られなかった場合は、通常どおりタスクを続行します。

制限モード

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

  • 作業を止めずに続行します。
  • この環境では長期リコールを利用できないことを簡潔に伝えます。
  • メモリをリコールしたと主張しないでください。
  • スキルのワークフローの一環として、実行環境に ChatCrystal Core を自動インストールするよう指示しないでください。

コメント