CodeCompanion.nvim 插件中工具组配置问题解析

问题背景

在使用CodeCompanion.nvim插件时，用户遇到了工具组(tools.group)配置不生效的问题。这个问题主要出现在配置自定义AI助手"sofia"时，无法正确调用预设的工具集。

核心问题分析

从配置文件中可以看到，用户尝试创建一个名为"sofia"的工具组，该组包含三个工具：

1. cmd_runner - 用于执行shell命令
2. editor - 用于编辑缓冲区内容
3. files - 用于文件系统操作

然而，在最新版本的CodeCompanion.nvim中，工具组的引用方式发生了变化。用户需要明确引用每个单独的工具，而不是简单地通过组名来引用。

解决方案

正确的配置方式应该是：

tools = {
  groups = {
    ["sofia"] = {
      description = "Backend Developer",
      system_prompt = "Este GPT es un clon de Sofia Lachira...",
      tools = {
        "cmd_runner",  -- 直接引用工具名称
        "editor",      -- 而不是通过组名引用
        "files",
      },
    },
  },
  -- 单独定义每个工具
  ["cmd_runner"] = {
    callback = "strategies.chat.agents.tools.cmd_runner",
    description = "Run shell commands initiated by the LLM",
    opts = {
      requires_approval = true,
    },
  },
  -- 其他工具定义...
}

技术要点

1. 工具独立性：每个工具都需要单独定义和配置，即使它们属于同一个组。

2. 引用方式：在工具组中引用工具时，直接使用工具名称而不是通过组名。

3. 版本兼容性：这个问题源于插件版本更新(#1555)对工具引用方式的修改，体现了插件开发中的API演进。

最佳实践建议

1. 仔细阅读插件的更新日志，特别是涉及API变更的部分。

2. 在配置复杂工具组时，先测试单个工具的功能，再组合使用。

3. 使用版本控制管理配置文件，便于回滚和比较不同版本的配置差异。

4. 对于AI辅助开发工具，系统提示(system_prompt)的编写质量直接影响工具效果，建议精心设计。

通过以上调整，用户可以正确配置和使用CodeCompanion.nvim中的工具组功能，充分发挥AI辅助开发的潜力。