Memory、Skills 和 Agent 未加载

本页帮助排查项目说明（记忆）、Skills、Agent 未按预期加载的问题。

​

记忆 / 项目说明未加载

项目说明文件（默认 AGENTS.md）未被载入上下文时：

• 文件名：确认文件名与 context.fileName 配置一致（默认 AGENTS.md）。
• 发现边界：向上查找会在遇到 context.memoryBoundaryMarkers（默认 .git）的目录时停止。文件若在边界之外则不会被发现。
• 额外目录：默认仅扫描当前目录。要从额外可信目录加载记忆，开启 context.loadMemoryFromIncludeDirectories。
• 发现上限：context.discoveryMaxDirs（默认 200）限制搜索目录数，超大仓库可能触及上限。
• 文件夹信任：未信任的目录不会加载项目内容。
• 用 /memory 查看当前加载的记忆来源。

​

Skills 未加载

• 用 /skills 查看已加载的 Skills 列表。
• 目录结构：Skill 需位于 skills/<name>/SKILL.md。确认目录层级与文件名正确。
• 来源优先级：Skills 来源为内置 < 插件 < 项目级 < 用户级，同名时高优先级覆盖低优先级。
• 条件 Skill：仅在文件路径匹配时激活，未匹配则不出现。
• 功能开关：/skills 需要 Skills 支持与管理员权限开启。

​

Agent 未加载

• 用 /agents 查看已加载的 Agent。
• 确认 Agent 定义文件位置与格式正确（agents/ 目录下的定义文件）。
• 检查 agents.overrides 是否将目标 Agent 设为禁用。
• 通过 --agents 加载的额外定义仅本次会话有效。

​

重新加载

• 修改定义后按对象重新加载：记忆用 /memory，Skills 用 /skills reload，Agent 用 /agents reload；自定义命令用 /commands。
• 上述方式无效时重启 Qoder CLI；部分加载相关配置标注“需重启”，修改后需重新启动。

​

下一步

• 上下文与记忆机制：记忆工作原理、记忆。
• 扩展加载问题：Hooks、MCP 和插件问题。
• 配置问题：配置不生效。