mcpField
C
chatcrystal-debug-recall

chatcrystal-debug-recall

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

关于 chatcrystal-debug-recall

面向使用 ChatCrystal Core 的 Agent 的调试技能，可在诊断前检索相关项目记忆；记忆不可用时仍可继续调试。

主要功能

  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 工具不可用：

  • 继续调试任务，不要因此受阻。
  • 简要说明长期调试回忆功能不可用。
  • 不要编造历史故障、原因或修复方法。
  • 不要将安装命令转化为自动技能步骤。

评论

支持 Markdown