mcpField
C
chatcrystal-task-recall

chatcrystal-task-recall

github.com/zengliangyiAgent 工作流6154 次安装5 天前更新
代码仓库

关于 chatcrystal-task-recall

这项技能为 ChatCrystal Core 提供任务前记忆检索工作流，适用于需要实现、重构、迁移、配置、调查或优化的非简单任务。它优先使用项目记忆，并在核心或 MCP 工具不可用时允许继续工作。

主要功能

  1. 01判断任务是否需要检索记忆
  2. 02提交任务目标与上下文
  3. 03优先采用项目记忆
  4. 04核心或工具不可用时继续

适用场景

  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 任务回忆

将此技能作为 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，以及通过 MCP 访问 recall_for_task。

  • 优先使用当前仓库或工作区路径，以便 Core 推导出 project_key。
  • 展示相关警告，例如 no-project-key 或 no-matches，但不要将其视为失败。
  • 如果回忆没有返回有用内容，照常继续任务。

降级模式

如果 ChatCrystal Core 或 MCP 工具不可用：

  • 不要因此阻塞，继续执行任务。
  • 简要说明此环境中无法进行长期回忆。
  • 不要声称回忆过任何记忆。
  • 不要指示运行时在技能工作流中自动安装 ChatCrystal Core。

评论

支持 Markdown