斜杠命令和 @ 语法
介绍
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-creator。
CLI常用@命令
接下来介绍CLI中几个常用的@命令。
-
打开文件
@[foldler name]。 打开指定文件夹,您也可用此方法打开指定文件。 -
调用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日