chatcrystal-task-recall

用途

ChatCrystal Task Recall 是叠加在 ChatCrystal Core 之上的薄工作流技能，用于在实际动手之前召回 ChatCrystal 记忆。技能本身不发明并行的记忆系统。

主要能力

判断任务是否值得召回：对非平凡的实现、重构、迁移、配置、排查或优化工作触发；对琐碎编辑、单行回答或纯对话请求跳过。
若 recall_for_task 可用，则在实质性工作前调用，返回项目记忆作为主要上下文，全局记忆作为补充上下文。
在提出或编写代码之前，应用召回到的坑、模式与过往决策。

使用方式

在实质性工作前调用 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：运行时存在稳定值时提供

示例 MCP 输入

用于实现或排查工作：

{
  "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。

适用场景

非平凡的实现、重构、迁移、配置、排查或优化工作。

限制

琐碎编辑、单行回答或纯对话请求不触发召回。降级模式下无法使用长期召回。完整模式依赖 ChatCrystal Core 与 MCP 访问，相关资料未提供具体的安装命令、价格或平台信息。