跳到主要内容

斜杠命令和 @ 语法

介绍​

Tuanjie AI 提供了强大的快捷指令系统，通过 / 斜杠命令和 @ 语法，您可以快速访问各种功能，高效地完成开发任务。这两个功能各有侧重，配合使用能大幅提升工作效率。

斜杠命令 /​

斜杠命令是 Tuanjie AI 预设的快捷指令系统，用于快速执行常用操作和管理系统功能。

核心特性：

  • 快速访问：无需记忆复杂命令，输入 / 即可查看可用命令列表
  • 系统管理：管理代理、技能、MCP 服务器等系统组件
  • 交互式操作：提供友好的交互式命令界面
  • 上下文感知：根据当前对话上下文提供相关命令建议

@ 语法​

@ 用于把上下文或能力引用进当前提示，常见目标包括：

  • 文件 / 文件夹：把路径内容加入对话上下文
  • Skill / MCP：快速选中已配置的技能或 MCP 资源
  • Subagent：在提示开头指定专家代理，将任务直接委托给该子智能体

核心特性：

  • 上下文增强：用 @ 精确带入文件、目录或外部资源
  • 专家委托：需要时可 @subagent_name 跳过主代理自动选择
  • 高效执行：减少来回说明路径或工具的时间
  • 灵活控制：同一套 @ 入口覆盖引用与委托

斜杠命令 / 使用指南​

打开命令菜单​

在对话框中输入 /，系统会自动显示所有可用的斜杠命令列表。您可以在GUI找到以下命令：

切换模型查看用量管理skill管理command管理extension查看快捷键
管理MCP Server管理subagent打开设置导出当前对话查看文档退出当前帐号
示例

以上是输入斜杠命令后GUI出现的部分命令列表。

CLI常用斜杠命令​

接下来介绍CLI中几个常用的斜杠命令。

技能管理 /skills​

管理 Tuanjie AI 的 Skills（可复用的专用能力）。

/skills list                           # 列出所有可用技能
/skills enable <skill_name>            # 启用指定技能
/skills disable <skill_name>           # 禁用指定技能
/skills reload                         # 重新加载技能配置

示例：

/skills list
# 查看所有可用技能

/skills enable skill-creator
# 启用技能创建器
MCP 管理 /mcp​

管理 Model Context Protocol (MCP) 服务器。

/mcp list                              # 列出所有 MCP 服务器
/mcp reload                            # 重新加载 MCP 服务器配置

示例：

/mcp list
# 查看已连接的 MCP 服务器

/mcp reload
# 重新加载 MCP 配置
自定义命令 /commands​

管理用户自定义的命令。

/commands list                         # 列出所有自定义命令
/commands reload                       # 重新加载自定义命令
帮助和反馈​
/help                                  # 显示帮助信息
/bug                                  # 报告 Bug 或提供反馈

@ 语法使用指南​

打开命令菜单​

在对话框中输入 @，系统会默认提示选择目标文件夹。 若您配置过skill、subagent或者MCP Server，通过@就能快速找到您已配置的内容。

配置过skill后

​上图中，预先配置过skill-creator。

CLI常用@命令​

接下来介绍CLI中几个常用的@命令。

  1. 打开文件 @[foldler name] 。 打开指定文件夹，您也可用此方法打开指定文件。

  2. 调用Subagent。 在提示的最开头使用 @ 符号后跟 subagent 的名称，明确地将任务定向到特定的 subagent。

@<subagent_name> <your_task_description>
场景使用方式说明
打开文件@[foldler name]打开指定文件夹，您也可用此方法打开指定文件
调用Subagent@subagent_name在提示的最开头使用 @ 符号后跟 subagent 的名称，明确地将任务定向到特定的 subagent。
代码库分析@codebase_investigator分析代码结构、依赖关系、架构
CLI 帮助@cli_help获取 Codely CLI 相关帮助
安全审计@security-auditor查找安全漏洞
性能分析@performance-analyzer分析性能瓶颈
Git 操作@git-expert处理版本控制任务
测试分析@test-analyst分析测试覆盖率
文档生成@api-documenter生成 API 文档

最佳实践​

1. 选择合适的使用方式​

  • 使用 / 命令：当需要管理系统配置、列出可用功能或执行管理操作时
  • 使用 @ 语法：当需要执行特定领域的专业任务时
  • 不使用任何前缀：当任务比较通用，让 Tuanjie AI 自动选择最合适的处理方式时

2. 熟悉常用命令​

记住常用的斜杠命令和 subagent 名称，提高操作效率：

常用斜杠命令：

/agents list          # 查看可用代理
/skills list          # 查看可用技能
/mcp list             # 查看 MCP 服务器
/help                 # 获取帮助

常用 Subagent：

@codebase_investigator  # 代码库分析
@cli_help              # CLI 帮助
@security-auditor      # 安全审计

3. 查看可用资源​

不确定有哪些可用的命令或 subagent 时：

  • 输入 / 查看所有斜杠命令
  • 使用 /agents list 查看所有可用的 subagent
  • 使用 /agents show <agent_name> 查看特定 subagent 的详细信息

4. 测试和调试​

  • 使用 /agents test <agent_name> <prompt> 测试 subagent 是否按预期工作
  • 使用 /agents reload 重新加载配置以应用更改
  • 遇到问题时使用 /bug 报告问题

5. 组合使用​

可以组合使用 / 命令和 @ 语法：

# 先启用一个 subagent
/agents enable browser_agent

# 然后直接使用它
@browser_agent 访问网站并提取信息

注意事项​

@ 语法注意事项​

  • 位置要求：@ 语法必须在提示的最开头
  • 名称匹配：Subagent 名称必须准确匹配（区分大小写）
  • 可用性检查：如果 subagent 未启用或不存在，主代理会尝试自己完成任务
  • 递归保护：Subagent 无法调用其他 subagent

斜杠命令注意事项​

  • 会话要求：某些命令（如 /agents）需要在交互式 CLI 会话中使用
  • 权限要求：某些管理操作可能需要适当的权限
  • 配置持久化：通过命令行进行的更改可能不会持久化，需要修改配置文件

相关资源​

  • Subagent 用户手册：/subagents
  • Skills 用户手册：/skills-experimental
  • MCP 用户手册：/MCP-guide
  • 自定义命令用户手册：/commands