chatcrystal-task-recall について
ChatCrystal Core 向けの作業前リコールワークフローです。実装、リファクタリング、移行、設定、調査、最適化などの重要な作業を対象とし、プロジェクトの記憶を優先します。Core や MCP ツールが使えない場合も作業を続けられます。
主な機能
- 01リコールが必要な作業を判定
- 02作業目標とコンテキストを送信
- 03プロジェクトの記憶を優先
- 04Core やツールがなくても続行
活用シーン
- 01実装やリファクタリング前に関連経験を参照
- 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 の上に軽量なワークフローとして使用します。このスキル内に別のメモリシステムを作らないでください。
ワークフロー
- タスクがリコールを行うに足る規模かどうかを判断します。
- 重要度の高い
implement、refactor、migration、config、investigate、またはoptimizationの作業では実行します。 - 軽微な編集、一行で済む回答、または純粋に会話を目的とするリクエストでは実行しません。
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
project_memoriesを主なコンテキストとして扱い、global_memoriesは補足情報として扱います。- リコールした注意点、パターン、過去の決定事項を、コードの提案や作成に先立って適用します。
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 を自動インストールするよう指示しないでください。
コメント
Markdown 対応