命令

通过斜杠命令快速控制 Qoder CLI 行为、唤起功能与管理会话

通过斜杠命令（又称 Command）控制 Qoder CLI 的行为，快速唤起特定任务。

命令是 Qoder CLI 中唤起特定任务的快捷方式，通过斜杠符号（/）前缀触发。在 TUI 模式下输入 / 可查看可用命令清单并选择执行。

​

快速开始

​

在 TUI 模式下使用命令

1. 启动 Qoder CLI 进入 TUI 模式：

   qodercli
   

2. 在输入框中输入 / 字符，查看可用命令清单

3. 选择目标命令后按 Enter 键执行，例如 /config 查看或修改 Qoder CLI 配置项：

   /config
   

​

在无头模式下使用命令

无头模式（又称 Headless 模式）支持执行会提交提示词的命令。需要打开交互式选择器或对话框的命令，应在 TUI 模式中使用。

# 执行命令（包含额外指令）
qodercli -p '/review 重点检查注释覆盖情况'

# 执行自定义 Prompt 命令
qodercli -p '/git-commit'

​

命令类型

Qoder CLI 中的命令分为两种类型：

类型	说明	适用模式	扩展性
TUI 类型	提供交互式界面（如弹出对话框、列表选择）	TUI	系统内置，不支持自定义
Prompt 类型	向对话中提交预设提示词，指导 CLI 完成特定任务	TUI + Headless	支持用户自定义扩展

​

内置命令

下表列出常用内置命令；完整命令清单、分类与别名以 斜杠命令参考 为准。

命令	类型	用途
/agents	TUI	查看和管理 Subagent 清单，支持创建、编辑 Subagent 配置
/tasks	TUI	查看和管理后台任务
/workflows	TUI	打开动态工作流任务面板。见 动态工作流
/clear	TUI	清除当前对话内容，开始新的对话
/commands	TUI	查看可用命令清单，按内置、动态、Skill、插件、工作流等分类浏览
/compact	Prompt	压缩对话历史，可指定关注重点
/settings（别名 /config）	TUI	配置管理，查看或修改 Qoder CLI 配置项
/export [filename]	TUI	导出当前会话到文件
/feedback	TUI	提交反馈或报告问题
/help	TUI	显示帮助信息
/init	TUI	初始化项目，分析项目结构并生成 AGENTS.md 记忆文件
/login	TUI	登录 Qoder CLI 账号
/logout	TUI	登出 Qoder CLI 账号
/mcp	TUI	MCP 服务管理
/memory	TUI	打开记忆概览；自动记忆启用时可打开 auto-memory folder，或用 /memory manage 管理主题文件
/model	TUI	查看和管理模型级别设置
/effort [level]	TUI	设置当前模型的思考深度；不传 level 时打开模型参数面板
/context-window	TUI	设置当前模型的上下文窗口；不传参时打开模型参数面板
/fast [on|off]	TUI	开关当前模型的快速模式；不传参时打开模型参数面板
/quest	Prompt	智能工作流编排器，多个智能体协同工作，协助用户完成功能开发
/quit	TUI	退出 Qoder CLI
/release-notes	TUI	查看版本更新说明
/resume	TUI	恢复之前的会话或对话历史，支持 Tab 键分页切换会话
/review	Prompt	执行代码审查，检查代码质量和规范性
/setup-github	TUI	GitHub 集成配置，设置 GitHub 相关功能
/skills	TUI	管理当前工作区的 Skill 命令
/status	TUI	查看当前会话状态和系统信息
/upgrade	TUI	升级订阅计划
/usage	TUI	查看使用情况统计，包括 Token 消耗等信息
/vim	TUI	启用或配置 Vim 模式，提供 Vim 风格编辑体验

​

创建自定义命令

Qoder CLI 支持创建 Prompt 类型的自定义命令，通过配置文件定义命令的名称、描述和系统提示词。

​

方式一：让 Qoder 生成（推荐）

直接在对话中描述你想要的命令，让 Qoder 按配置文件格式生成并写入对应目录。例如：

> 帮我创建一个自定义命令：查看所有 git 改动并生成一条规范的提交信息，保存为项目级命令

生成完成后，可在以下目录找到并编辑配置文件：

# 项目级
.qoder/commands/

# 用户级
~/.qoder/commands/

/commands 面板用于按分类（内置、动态、Skill、插件、工作流等）查看当前可用的命令清单，不提供创建入口。

​

方式二：手动编写配置

直接编写 Markdown 格式的命令配置文件，完全控制命令的提示词内容。

​

配置文件格式

命令配置文件为 Markdown 格式，包含 frontmatter 元数据和系统提示词：

---
name: command-name
description: 命令的作用描述，将在 TUI 命令清单中显示
---

这里是命令的系统提示词内容。
当用户执行该命令时，这段提示词会被提交到对话中，指导 CLI 完成特定任务。

可以使用多行文本，支持 Markdown 格式。

字段说明：

字段	必填	说明
name	否	命令在 TUI 中的展示名；调用名由文件路径决定，不受此字段影响
description	是	命令的功能描述，支持多行文本（使用 YAML 语法）

命名规范：

• 使用小写字母和连字符（例如 git-commit）
• 避免使用空格或特殊字符
• 建议文件名与 name 字段保持一致
• 子目录中的命令使用 : 作为命名空间分隔符，例如 commands/git/commit.md 注册为 /git:commit
• frontmatter.name 仅作为 TUI 中的展示名，命令调用名始终由文件路径推导
• 同目录下若存在 SKILL.md，该目录会注册为单个命令（如 /git），目录内其它兄弟 .md 文件会被忽略
• 命令名段会原样保留，不做字符替换；建议在文件名中坚持使用易于输入的字符

​

配置示例

以下是一个用于生成 Git 提交信息的命令配置示例：

---
name: git-commit
description: Use this command when you need to review all git changes in the current repository and generate a well-structured commit message. This is particularly useful before committing code changes, especially after completing a feature or fixing a bug.
---

You are an expert Git commit message generator. Your role is to analyze all git changes in the repository and create clear, concise, and meaningful commit messages that follow conventional commit standards.

When analyzing changes, you will:
1. Examine all staged and unstaged changes using `git diff` and related commands
2. Identify the type of changes (feat, fix, chore, docs, style, refactor, test, etc.)
3. Determine the scope of changes (which component/module was affected)
4. Summarize the primary change in a clear subject line (50 characters or less)
5. Provide a detailed body explanation if the changes are complex
6. Follow conventional commit format: `<type>(<scope>): <subject>`

Your commit message structure should be:
- Subject line: Brief summary starting with change type
- Blank line
- Body (if needed): Detailed explanation of what changed and why
- Wrap lines at 72 characters

Best practices you follow:
- Use imperative mood ("add" not "added")
- Be specific about what was changed
- Reference issue numbers when relevant
- Keep subject line under 50 characters
- Explain the 'why' behind significant changes
- Group related changes logically

If you encounter unclear changes or need more context, ask clarifying questions. If there are no changes, inform the user accordingly. Always verify your analysis covers all modifications before generating the final commit message.

​

存储位置与优先级

命令配置文件可以存储在项目级或用户级目录中：

级别	路径	生效范围	提交到代码仓库
项目级	.qoder/commands/<command_name>.md	仅当前项目	建议提交（团队共享）
用户级	~/.qoder/commands/<command_name>.md	所有项目	不提交（个人配置）

优先级: 如果项目级和用户级存在同名命令，项目级命令优先生效。

在 Qoder CLI 已启动的情况下，新增或修改命令配置文件后，运行 /commands 即可重新加载并查看可用命令。

​

查看和使用自定义命令

​

查看命令清单

1. 在 TUI 中执行 /commands 打开命令清单面板
2. 通过 Tab 键在分类标签页之间切换（Built-in、Dynamic、Skill、Plugin、Workflow 等，仅显示存在命令的分类，标签上会标注数量）
3. 使用上下键浏览，列表中会显示每个命令的名称与描述；自定义命令归入 Dynamic 分类
4. 使用 Esc 键退出面板

面板仅用于浏览。想查看某个自定义命令的完整系统提示词，直接打开对应的配置文件（.qoder/commands/ 或 ~/.qoder/commands/ 下的 .md 文件）。

​

执行命令

在 TUI 输入框中输入命令名称（以 / 开头），CLI 会自动显示匹配的命令列表：

╭───────────────────────────────────────────────────────╮
│ > /git-commit                                                                         │
╰───────────────────────────────────────────────────────╯
  /git-commit        [user] Use this command when you need to review all git changes ...

按 Enter 键发送命令，CLI 会按照命令配置中的系统提示词开始执行任务：

> /git-commit

● I'll help you create a commit message by analyzing the git changes in your repository.
  Let me first check the current status.

● Bash (git status)
...

​

常见问题

​

自定义命令无法识别

问题: 创建的自定义命令在 TUI 中无法显示或执行

解决方案:

1. 检查配置文件路径是否正确（~/.qoder/commands/ 或 .qoder/commands/）
2. 检查 frontmatter 格式是否正确（以 --- 开头和结尾）
3. 运行 /commands 重新加载命令列表。如果仍未识别，再重启 CLI（使用 /quit 退出后重新运行 qodercli）

​

Frontmatter 解析失败

问题: 命令配置的 YAML 格式不正确

解决方案:

• 确保 frontmatter 以 --- 开头和结尾
• 使用 | 语法定义多行 description 字段
• 检查缩进是否正确（YAML 对缩进敏感）

---
name: my-command
description: |
  这是第一行描述
  这是第二行描述
---