CLI 命令系统
架构概述
入口
CLI 入口由 Commander.js 解析命令行参数，随后启动 REPL（交互式循环）。REPL 负责接收用户输入、解析斜杠命令、调用对应的处理函数。
命令注册
命令通过 6 种来源 注册到系统：
| 来源 | 说明 | 注册位置 |
|---|---|---|
| 内置命令 | COMMANDS() 函数返回的核心命令列表 |
src/commands.ts:261-354 |
| 内置技能 | 随 CLI 打包的 Markdown 技能文件 | getBundledSkills() |
| 内置插件 | 内置插件导出的技能命令 | getBuiltinPluginSkillCommands() |
| 用户技能目录 | 用户自定义的 Markdown 技能文件 | getSkillDirCommands() |
| 工作流 | 多步骤脚本工作流 | getWorkflowCommands() |
| 市场插件 | 从插件市场安装的外部插件 | getPluginCommands(), getPluginSkills() |
命令过滤
getCommands() 是命令的最终汇聚函数，执行以下过滤：
- availability 检查：
meetsAvailabilityRequirement()— 验证当前用户是否有权限（如 claude.ai 订阅者、Console API 用户） - isEnabled 检查：
isCommandEnabled()— feature flag 控制是否启用 - 去重：内置命令与动态技能（
getDynamicSkills()）间去重，内置命令优先 - 动态技能插入：在插件命令之后、内置命令之前插入
远程模式过滤
REMOTE_SAFE_COMMANDS 集合定义了可在 --remote 模式下安全使用的命令（仅影响本地 TUI 状态）。
BRIDGE_SAFE_COMMANDS 和 isBridgeSafeCommand() 定义了可通过 Remote Control bridge（移动端/web 客户端）执行的命令。
内置命令详表
以下为 COMMANDS() 中注册的所有内置命令，按功能分组：
导航与信息
| 命令 | 别名 | 描述 |
|---|---|---|
/help |
- | 显示帮助信息，列出所有可用命令 |
/clear |
- | 清屏，重置终端显示 |
/exit |
- | 退出 CLI |
/init |
- | 在项目中初始化 Claude Code 配置文件 |
/resume |
- | 恢复之前的会话 |
/status |
- | 显示当前会话状态 |
/stats |
- | 统计信息和指标 |
配置管理
| 命令 | 别名 | 描述 |
|---|---|---|
/config |
- | 系统设置管理（theme, model, permissions 等） |
/model |
- | 切换 AI 模型 |
/theme |
- | 切换终端主题 |
/color |
- | 更改 AI 回复颜色 |
/permissions |
- | 权限模式管理 |
/privacySettings |
- | 隐私设置 |
/outputStyle |
- | 输出风格切换 |
/statusline |
- | 状态行开关 |
/effort |
- | 设置思考/推理投入度 |
/fast |
- | 快速模式切换 |
/env |
ant 内部 | 环境变量管理 |
/remoteEnv |
- | 远程环境变量管理 |
/passes |
- | 管理预设的 always-allow/always-deny 规则 |
会话管理
| 命令 | 别名 | 描述 |
|---|---|---|
/session |
- | 会话管理（分享、导出、查看记录） |
/cost |
- | 显示当前会话费用 |
/usage |
- | 显示 API 用量 |
/compact |
- | 压缩上下文，减少 token 消耗 |
/copy |
- | 复制最后一条消息 |
/rename |
- | 重命名当前会话 |
/tag |
- | 为会话添加标签 |
/btw |
- | 快速记笔记，补充上下文 |
/rewind |
- | 回滚到之前的对话状态 |
工具与技能
| 命令 | 别名 | 描述 |
|---|---|---|
/skills |
- | 管理技能（列出、启用、禁用） |
/mcp |
- | MCP 服务器管理（添加、连接、查看） |
/plugin |
- | 插件管理 |
/reloadPlugins |
- | 重新加载所有插件 |
/hooks |
- | 钩子系统管理 |
/keys / /keybindings |
- | 快捷键管理 |
/add-dir |
- | 添加技能目录 |
/terminalSetup |
- | 终端设置工具 |
语音与 Friend
| 命令 | 别名 | 描述 |
|---|---|---|
/voice |
feature 控制 | 语音听写模式 |
/friend |
- | Friend 虚拟宠物管理 |
/thinkback |
- | Thinkback 回放 |
/thinkbackPlay |
- | Thinkback 播放控制 |
Goal 与规划
| 命令 | 别名 | 描述 |
|---|---|---|
/goal / /goals |
- | 目标管理（创建、查看、更新） |
/plan |
- | 规划模式切换 |
/ultraplan |
feature 控制 | 高级规划模式 |
/agent / /agents |
- | 代理管理（列出、配置） |
/tasks |
- | 后台任务管理 |
Git 与文件
| 命令 | 别名 | 描述 |
|---|---|---|
/diff |
- | 显示 Git diff |
/branch |
- | 分支管理 |
/files |
- | 显示会话中跟踪的文件 |
/commit |
ant 内部 | 创建 Git 提交 |
/commit-push-pr |
ant 内部 | 提交、推送、创建 PR |
/fork |
feature 控制 | Fork 子代理 |
/buddy |
feature 控制 | 协作编程伙伴 |
集成与外部服务
| 命令 | 别名 | 描述 |
|---|---|---|
/login |
- | 登录（非 3P 用户） |
/logout |
- | 登出 |
/feishu |
- | 飞书集成 |
/telegram |
- | Telegram 集成 |
/desktop |
- | 桌面应用模式 |
/mobile |
- | 移动端二维码 |
/install-github-app |
- | 安装 GitHub App |
/install-slack-app |
- | 安装 Slack App |
/bridge |
feature 控制 | 桥接模式 |
/peers |
feature 控制 | UDS 对等节点管理 |
/subscribe-pr |
feature 控制 | 订阅 PR 通知 |
诊断与开发
| 命令 | 别名 | 描述 |
|---|---|---|
/doctor |
- | 系统诊断，检查配置和依赖 |
/upgrade |
- | 升级 CLI 版本 |
/version |
ant 内部 | 显示版本信息 |
/heapdump |
- | 堆转储（调试用） |
/sandbox-toggle |
- | 沙箱模式开关 |
/debug-tool-call |
ant 内部 | 调试工具调用 |
/perf-issue |
ant 内部 | 性能问题报告 |
/ant-trace |
ant 内部 | Ant 追踪 |
/oauth-refresh |
ant 内部 | OAuth token 刷新 |
/color |
- | 更改 AI 颜色 |
/stickers |
- | 贴纸管理 |
反馈与分析
| 命令 | 别名 | 描述 |
|---|---|---|
/feedback |
- | 发送反馈 |
/review |
- | 代码审查 |
/ultrareview |
- | 深度代码审查 |
/security-review |
- | 安全审查 |
/insights |
- | 会话分析报告 |
/extra-usage |
- | 额外用量显示 |
/rate-limit-options |
- | 速率限制选项 |
/summary |
ant 内部 | 会话摘要生成 |
/share |
ant 内部 | 分享会话 |
/release-notes |
- | 版本发布说明 |
/cost |
- | 会话费用 |
/usage |
- | 使用情况 |
实验性 & Feature-gated
| 命令 | 别名 | 描述 |
|---|---|---|
/proactive |
feature 控制 | 主动模式 |
/brief |
feature 控制 | 简报模式 |
/assistant |
feature 控制 | 助手模式 |
/torch |
feature 控制 | Torch 调试工具 |
/web / /remote-setup |
feature 控制 | 远程设置 |
/workflows |
feature 控制 | 工作流管理 |
/force-snip |
feature 控制 | 强制截断上下文 |
/remoteControlServer |
feature 控制 | 远程控制服务器 |
/buddy |
feature 控制 | 编程伙伴 |
/agents-platform |
ant 内部 | 代理平台管理 |
/bughunter |
ant 内部 | Bug 猎人工具 |
/autofix-pr |
ant 内部 | 自动修复 PR |
/backfill-sessions |
ant 内部 | 回填会话数据 |
/issue |
ant 内部 | 问题管理 |
/onboarding |
ant 内部 | 引导流程 |
/teleport |
ant 内部 | 远程会话跳转 |
/good-claude |
ant 内部 | 内部工具 |
/ctx_viz |
ant 内部 | 上下文可视化 |
/mock-limits |
ant 内部 | Mock 限制测试 |
/bridge-kick |
ant 内部 | 桥接踢出 |
/reset-limits |
ant 内部 | 重置限制 |
Skill 系统
技能（Skills）是以 Markdown 文件形式定义的提示词模板，可被 LLM 或用户调用。技能系统分为：
- 打包技能（Bundled Skills）：随 CLI 发布的内置
.md文件 - 用户技能目录（Skill Dir Commands）：用户在工作区
./claude/skills/或全局~/.claude/skills/中定义的技能 - 插件技能（Plugin Skills）：从插件加载的技能
- MCP 技能：通过 MCP 协议提供的技能（
getMcpSkillCommands()）
技能文件的 YAML frontmatter 定义 name、description、model 等属性，正文为发送给 LLM 的提示词。
技能相关工具
SkillTool：AI 可调用的技能执行工具getSkillToolCommands()：获取所有可被模型调用的 prompt 类型命令getSlashCommandToolSkills()：获取斜杠命令可用的技能列表
工作流系统
工作流（Workflows）是通过 WorkflowTool 实现的多步骤脚本，支持：
- 顺序执行多个步骤
- 条件分支
- 变量传递
- 用户确认点
当 WORKFLOW_SCRIPTS feature flag 启用时，工作流命令通过 createWorkflowCommand() 注册。
命令类型
Command 类型包括三种变体：
| 类型 | 说明 |
|---|---|
prompt |
扩展为提示词发送给模型（技能、工作流） |
local |
本地执行，输出纯文本 |
local-jsx |
本地执行，渲染 Ink UI 组件 |
配置管理
/config 命令管理系统设置。配置值存储在：
- 用户设置：
~/.claude/settings.json - 项目设置：
.claude/settings.json（项目级覆盖） - 会话设置：仅当前会话有效
支持的配置项包括 theme、model、permissions（权限模式）、音效、通知等。
相关文件：
/home/yuki/Code/Agent/Codev/src/commands.ts— 命令注册与过滤核心/home/yuki/Code/Agent/Codev/src/types/command.ts— Command 类型定义/home/yuki/Code/Agent/Codev/src/skills/loadSkillsDir.ts— 技能目录加载/home/yuki/Code/Agent/Codev/src/tools/WorkflowTool/— 工作流工具实现