嵌套agent在opencode使用有点疑问

[githubzijian]

张老师，您好， https://learnopencode.com/4-scenarios/writer-workstation.html#嵌套-agent
我的测试如下：
jian@jiandeMac-Pro my-test % tree .opencode -L 3
.opencode
├── agent
│ └── writing
│ └── writer.md这里的writer.md是在 agent/writing目录下的，tree复制出的文本路径似乎显示不那么准确）

此时在opencode使用可以通过@writer 直接使用， 而不是 @writing/writer

[javazys]

感谢你的反馈！这是一个很好的问题，我已经修复了教程文档。

问题原因

OpenCode 中 agent 名称的生成规则是：

1. 默认行为：系统会从文件路径自动生成 agent 名称

   • 文件：
   • 自动生成的名称：
   • 调用方式：

2. 如果有 字段：会覆盖默认生成的名称

   • 如果 frontmatter 中设置了
   • 最终的 agent 名称：
   • 调用方式：

所以你遇到的情况应该是：你的 文件中 frontmatter 里设置了 ，所以 agent 名称被覆盖为 ，而不是 。

已修复的教程

我已经更新了以下教程文件，补充了完整的说明：

1. A9 打造创作工作站 - 嵌套 Agent 章节
2. 5.2a 快速入门 - 踩坑提醒表格
3. 5.2d 高级技巧 - 嵌套子目录 Agent 章节

现在教程中明确说明了：

💡 调用方式说明

• 不设置 name 字段：系统会自动使用完整路径作为 agent 名称，如 ，调用方式为
• 设置 name 字段：会覆盖自动生成的名称，如设置 ，调用方式为
• 推荐做法：嵌套目录的 agent 不要在 frontmatter 中设置 字段，让系统自动生成包含路径的名称。

建议

如果你想要使用 的调用方式，可以从 frontmatter 中移除 字段，让系统自动生成名称。

希望这个解释对你有帮助！如果还有疑问，欢迎继续交流。🙏