跳到主要内容

斜杠命令和 @ 语法

介绍

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

斜杠命令 /

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

核心特性:

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

@ 语法

@ 语法用于强制调用特定的 Subagent(专家代理),将任务直接委托给专业领域的 AI 助手。

核心特性:

  • 专家委托:直接指定处理任务的专家代理
  • 绕过决策:跳过主代理的自动选择,明确指定执行者
  • 高效执行:减少理解上下文的时间,直接获得专业建议
  • 灵活控制:用户可以精确控制任务的执行方式

斜杠命令 / 使用指南

打开命令菜单

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

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

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

CLI常用斜杠命令

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

代理管理 /subagents

管理 Tuanjie AI 的 Subagent(专家代理)。

/subagents list                           # 列出所有可用的代理
/subagents show <agent_name> # 显示特定代理的详细信息
/subagents enable <agent_name> # 启用指定的代理
/subagents disable <agent_name> # 禁用指定的代理
/subagents reload # 重新加载代理配置
/subagents test <agent_name> <prompt> # 测试指定代理

示例:

/subagents list
# 输出:
# ✓ codebase_investigator (enabled)
# ✓ cli_help (enabled)
# ✗ browser_agent (disabled)
# ✓ security-auditor (enabled)

/subagents enable browser_agent
# 启用浏览器代理

/subagents test codebase_investigator "解释认证系统的架构"
# 测试代码调查代理
技能管理 /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

文档版本:2.0 最后更新:2026年3月25日