03-Commands系统完整指南

03 Commands系统完整指南 03 Commands系统完整指南 Modified May 9 Code block Markdown Copy description: 代码审查命令 检查代码质量和潜在问题 argument hint: <文件路径 allowed tools: Read Grep 代码审查命令 任务 对指定文件进行代码审查，检查代码质量。 参数 文件路径：$ARGUMENTS 执行流程 步骤1：验证参数 如果 $ARGUMENTS 为空，提示用户提供文件路径。 步骤2：读取文件 使用Read工具读取文件内容： Read("$ARGUMENTS") Code block Plain Text Copy 步骤3：执行审查 从以下维度审查代码： 1. 代码风格 命名规范 缩进一致性 注释完整性 2. 潜在Bug 空值检查 边界条件 异常处理 3. 安全问题 SQL注入风险 XSS风险 敏感信息泄露 4. 性能问题 循环优化 数据结构选择 资源释放 步骤4：输出报告 输出格式 代码审查报告 文件：[文件路径]审查时间：[当前时间] 总体评分：X/100 严重问题（必须修复）： • [问题1]：[位置] [说明] 建议改进： • [建议1]：[位置] [说明] 代码亮点： • [亮点1] Code block Plain Text Copy 测试 ： bash /daily flow /daily flow Claude Code 附录A：命令速查表 内置命令速查 分类 命令 功能 会话管理 /clear 清空对话历史 /compact 压缩对话 /resume 恢复会话 /export 导出对话 /rename 重命名会话 /branch 创建会话分支 上下文 /context 查看Token使用 /cost 费用与用量（v2.1.92+ 订阅：per model / cache hit，见 release） /model 切换模型 /effort 推理深度控制 /usage 使用量统计 项目 /init 初始化项目 /memory 编辑记忆 /permissions 管理权限 /add dir 添加目录 开发 /security review 安全审查 /tasks 后台任务管理 /rewind 回退功能 诊断 /doctor 系统诊断 /status 完整状态 /stats 使用统计 /powerup 交互式教程（v2.1.90+） MCP /mcp 管理MCP /hooks 管理Hooks 其他 /help 显示帮助 /release notes 更新日志（v2.1.92+ 交互选版本） /loop Bundled skill：定时循环执行 /sandbox 沙箱隔离模式 /color 会话颜色设置 Read("$ARGUMENTS") 代码审查报告 文件：[文件路径]审查时间：[当前时间] 总体评分：X/100 严重问题（必须修复）： • [问题1]：[位置] [说明] 建议改进： • [建议1]：[位置] [说明] 代码亮点： • [亮点1] bash /code review src/main.py Code block Markdown Copy description: 每日内容创作工作流 从热点到成稿一站式完成 argument hint: [热点关键词（可选）] allowed tools: Read Write WebSearch Bash 每日内容创作工作流 任务 执行完整的每日内容创作流程。 参数 可选热点关键词：$ARGUMENTS 执行流程 阶段1：热点扫描 执行热点扫描，获取今日AI热点。 如果提供了关键词 $ARGUMENTS，则重点搜索相关热点。 如果没有提供，则全面扫描。 阶段2：选题决策 从热点中选择最适合写作的主题： 评估时效性 评估受众匹配度 评估内容价值 输出选题理由。 阶段3：文章创作 使用选定的主题执行写作： 调用 /write [选定主题] 等待文章生成完成 阶段4：标题优化 调用 /title gen 生成更多标题候选 选择最佳标题 阶段5：质量检查 调用 /pre check 进行发布前检查 如果有问题，进行修复 直到检查通过 阶段6：完成报告 输出工作报告： Code block Plain Text Copy 测试 ： 附录A：命令速查表 内置命令速查 分类 命令 功能 会话管理 /clear 清空对话历史 /compact 压缩对话 /resume 恢复会话 /export 导出对话 /rename 重命名会话 /branch 创建会话分支 上下文 /context 查看Token使用 /cost 费用与用量（v2.1.92+ 订阅：per model / cache hit，见 release） /model 切换模型 /effort 推理深度控制 /usage 使用量统计 项目 /init 初始化项目 /memory 编辑记忆 /permissions 管理权限 /add dir 添加目录 开发 /security review 安全审查 /tasks 后台任务管理 /rewind 回退功能 诊断 /doctor 系统诊断 /status 完整状态 /stats 使用统计 /powerup 交互式教程（v2.1.90+） MCP /mcp 管理MCP /hooks 管理Hooks 其他 /help 显示帮助 /release notes 更新日志（v2.1.92+ 交互选版本） /loop Bundled skill：定时循环执行 /sandbox 沙箱隔离模式 /color 会话颜色设置 分类 分类 命令 命令 功能 功能 会话管理 会话管理 /clear /clear 清空对话历史 清空对话历史 /compact /compact 压缩对话 压缩对话 /resume /resume 恢复会话 恢复会话 /export /export 导出对话 导出对话 /rename /rename 重命名会话 重命名会话 /branch /branch 创建会话分支 创建会话分支 上下文 上下文 /context /context 查看Token使用 查看Token使用 /cost /cost 费用与用量（v2.1.92+ 订阅：per model / cache hit，见 release） 费用与用量（v2.1.92+ 订阅：per model / cache hit，见 release） /model /model 切换模型 切换模型 /effort /effort 推理深度控制 推理深度控制 /usage /usage 使用量统计 使用量统计 项目 项目 /init /init 初始化项目 初始化项目 /memory /memory 编辑记忆 编辑记忆 /permissions /permissions 管理权限 管理权限 /add dir /add dir 添加目录 添加目录 开发 开发 /security review /security review 安全审查 安全审查 /tasks /tasks 后台任务管理 后台任务管理 /rewind /rewind 回退功能 回退功能 诊断 诊断 /doctor /doctor 系统诊断 系统诊断 /status /status 完整状态 完整状态 /stats /stats 使用统计 使用统计 /powerup /powerup 交互式教程（v2.1.90+） 交互式教程（v2.1.90+） MCP MCP /mcp /mcp 管理MCP 管理MCP /hooks /hooks 管理Hooks 管理Hooks 其他 其他 /help /help 显示帮助 显示帮助 /release notes /release notes 更新日志（v2.1.92+ 交互选版本） 更新日志（v2.1.92+ 交互选版本） /loop /loop Bundled skill：定时循环执行 Bundled skill：定时循环执行 /sandbox /sandbox 沙箱隔离模式 沙箱隔离模式 /color /color 会话颜色设置 会话颜色设置 /copy 复制AI回复 /skills 查看/搜索 Skills 🆕 /proactive /loop 别名（v2.1.105+）🆕 frontmatter配置速查 命令文件模板 [输出模板] 附录B：社区资源 官方资源 • Claude Code官方文档 Claude Code官方文档 • Slash Commands文档 Slash Commands文档 • Anthropic最佳实践 Anthropic最佳实践 社区项目 • Claude Command Suite 148+专业命令 Claude Command Suite • Awesome Claude Code 社区精选资源 Awesome Claude Code 相关课程 • 第1部分：环境与安装 Claude Code安装配置 • 第2部分：基础使用 CLI启动和交互模式 • 第4部分：MCP集成 外部工具连接 • 第5部分：Hooks系统 自动化工作流 • 第6部分：Skills定制 技能包开发 学习总结 通过本课学习，你已经掌握： 1. Commands核心概念：Slash命令就是Markdown提示词文件 2. 自定义命令开发：frontmatter配置、$ARGUMENTS参数处理、工具调用 3. 高级技巧：命令命名空间、组合调用、模块化设计 4. 社区资源：Claude Command Suite等专业命令库 5. 故障排查：常见问题诊断和解决方法 温馨提示：内置命令详细用法请回顾「02 基础使用完整指南」 下一步建议： 1. 从第二部分的简单示例开始实践 2. 根据你的项目需求，创建第一个实用命令 3. 参考第四部分的实战案例，逐步构建命令库 4. 探索社区资源，学习优秀命令的设计模式 记住：Commands的核心价值是"一次配置，永久使用"。花时间设计好命令，能让你的开发效率翻倍！ 课程反馈：如果本教程对你有帮助，欢迎分享给更多人！ 问题反馈：遇到问题可以使用 /bug 命令报告，或在社区提问。 Commands系统完整指南：从 Slash 命令到 Skills 工作流的全面精通 课程信息 • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 预计学时：4 6小时 • 难度等级：⭐⭐ 入门级 • 更新日期：2026年4月 • 适用版本：Claude Code v2.1.133（验证于 2026 05 08） • 信息来源：内置命令参考 | Skills 官方文档 | Claude Command Suite | 最佳实践 • 前置要求：已完成Claude Code安装和基础使用 https://aiking.dev 内置命令参考 Skills 官方文档 Claude Command Suite 最佳实践 课程信息 • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev https://aiking.dev • 预计学时：4 6小时 • 难度等级：⭐⭐ 入门级 • 更新日期：2026年4月 • 适用版本：Claude Code v2.1.133（验证于 2026 05 08） • 信息来源：内置命令参考 | Skills 官方文档 | Claude Command Suite | 最佳实践 内置命令参考 Skills 官方文档 Claude Command Suite 最佳实践 • 前置要求：已完成Claude Code安装和基础使用 本课学习目标 完成本课学习后，你将能够： 1. 理解Commands本质：掌握Slash命令就是Markdown提示词的核心概念 2. 5分钟创建第一个命令：从零开始创建并运行自定义命令 3. 分清 legacy commands 与 Skills：知道什么时候继续用 .claude/commands/，什么时候应该迁移到 Skills 4. 掌握内置命令的新表面：了解 /plan、/plugin、/release notes、/rewind、/insights、/schedule、/statusline 5. 组合命令构建工作流：将多个命令串联成自动化流程 6. 排查命令故障：独立解决90%的常见配置和执行问题 7. 掌握frontmatter配置：使用description、allowed tools、model等高级配置 8. 精通$ARGUMENTS参数：接收和解析用户输入参数 前置知识：本教程假设你已掌握02教程中的30+内置命令用法，重点讲解自定义命令开发。 2026 04 差量更新（先读） 这章最容易踩的坑，是把 自定义 slash 命令 和 Skills 工作流 混成一件事。当前官方实践已经发生变化： • 新的自定义 slash 工作流，优先用 Skills。官方文档已把自定义命令能力并入 Skills 体系来管理和分享。 • .claude/commands/ 和 /.claude/commands/ 仍然可用，但更适合兼容旧项目、快速做局部 prompt 包装，或者理解 slash mechanics。 • 内置命令面板在 2.1.92 已明显扩展，不再只盯着旧版 /clear、/doctor、/loop 这一批。 • 要分清 built in commands 和 bundled skills：/loop 会出现在 slash 菜单里，但官方把它归到 bundled skills，不是固定逻辑的 built in command。 • 命令状态也在变化：/review 当前仍在官方 Commands Reference 中；/pr comments 已在 v2.1.91 移除，/vim 已在 v2.1.92 移除（release 原文：Removed /vim command (toggle vim mode via /config → Editor mode)，见 v2.1.92 release）。 v2.1.92 release • v2.1.90 起新增 /powerup（交互式课程 + 动画演示，见 v2.1.90 release）。 v2.1.90 release 因此，这一章请这样读： • 你在维护旧仓库或需要最轻量的本地 slash 包装：继续看 .claude/commands/ 示例。 • 你在新建团队工作流、可复用能力包、可分享的 slash 入口：优先同时参考 07 Skills定制完整指南。 07 Skills定制完整指南 v2.1.93 → v2.1.133 命令系统增强 v2.1.105+： • /proactive：/loop 的别名，功能完全相同。如果你觉得 "loop" 不够语义化，可以用 /proactive。 • /model 增强选择器：模型切换界面增加了更多信息和筛选选项。 v2.1.114+： • /theme 支持自定义颜色方案（Plugin 可声明 color palette）。 • /color 随机模式：直接输入 /color random 随机分配颜色，适合多会话管理。 v2.1.121+： • /mcp 工具计数：/mcp 列表现在显示每个 MCP Server 提供的工具数量。 • /skills 搜索过滤：支持关键词过滤（/skills <关键词 ），方便管理大量 Skills。 v2.1.129+： • skillOverrides 设置：可通过 settings 控制每个 Skill 的可见性（off / user invocable only / name only）。详见 07 Skills定制完整指南。 07 Skills定制完整指南 学习路径导航（先看这里！） 根据你的情况选择学习路径：这是一篇长教程，不用全看！根据你的目标选择路径。 路径A：5分钟快速上手 适合人群：急着体验自定义命令，想快速跑起来 只看这些章节（其他跳过）： 5分钟后你能达到：成功创建第一个自定义命令并运行 路径B：完整学习（3 4小时） 适合人群：想系统掌握Commands系统，成为命令开发高手 学习顺序：从头到尾所有章节 建议分段学习： • 第1天（30分钟）：第1 3部分（简介+快速开始+内置命令速查） • 第2天（1.5小时）：第4部分（自定义命令开发）⭐ 核心内容 • 第3天（1小时）：第5部分（高级用法） • 第4天（0.5小时）：第6 7部分（FAQ+附录） 注意：内置命令的详细用法已在「02 基础使用完整指南」中讲解，本教程重点是自定义命令开发！ 路径C：问题速查（5分钟） 适合人群：命令不工作，需要快速解决 直接跳到： 使用方法： 1. 按 Ctrl + F 搜索你的问题关键词 2. 找到对应的Q&A 3. 按步骤解决 路径D：专项学习（30 60分钟/主题） 适合人群：已经会基础命令，想深入某个功能 想学什么 看哪几节 预计时间 frontmatter配置 第4.3节 30分钟 参数处理 第4.4节 30分钟 工具调用 第4.5节 45分钟 命令组合 第5.2节 30分钟 社区命令库 第5.4节 20分钟 想学什么 想学什么 看哪几节 看哪几节 预计时间 预计时间 frontmatter配置 frontmatter配置 第4.3节 第4.3节 30分钟 30分钟 参数处理 参数处理 第4.4节 第4.4节 30分钟 30分钟 工具调用 工具调用 第4.5节 第4.5节 45分钟 45分钟 命令组合 命令组合 第5.2节 第5.2节 30分钟 30分钟 社区命令库 社区命令库 第5.4节 第5.4节 20分钟 20分钟 术语表（小白必读） 在开始之前，先了解这些关键术语。用生活类比帮助理解： 术语 英文全称 通俗解释 生活类比 Slash命令 Slash Commands 以"/"开头的快捷指令 手机快捷方式（一点就打开App） 自定义命令 Custom Commands 你自己创建的命令 自己设置的手机快捷方式 内置命令 Built in Commands Claude Code自带的命令 手机出厂预装的App frontmatter • 命令文件开头的配置区（YAML格式，见下方说明） 书的封面信息（书名、作者等） $ARGUMENTS • 接收用户输入参数的变量 快递单上的"收件人"空格 allowed tools • 允许命令使用的工具列表 工具箱（限定可用的工具） 命令作用域 Command Scope 命令生效的范围（项目级/用户级） 门禁卡（有的只能开一个门，有的能开所有门） 术语 术语 英文全称 英文全称 通俗解释 通俗解释 生活类比 生活类比 Slash命令 Slash命令 Slash Commands Slash Commands 以"/"开头的快捷指令 以"/"开头的快捷指令 手机快捷方式（一点就打开App） 手机快捷方式（一点就打开App） 自定义命令 自定义命令 Custom Commands Custom Commands 你自己创建的命令 你自己创建的命令 自己设置的手机快捷方式 自己设置的手机快捷方式 内置命令 内置命令 Built in Commands Built in Commands Claude Code自带的命令 Claude Code自带的命令 手机出厂预装的App 手机出厂预装的App frontmatter frontmatter • • 命令文件开头的配置区（YAML格式，见下方说明） 命令文件开头的配置区（YAML格式，见下方说明） 书的封面信息（书名、作者等） 书的封面信息（书名、作者等） $ARGUMENTS $ARGUMENTS • • 接收用户输入参数的变量 接收用户输入参数的变量 快递单上的"收件人"空格 快递单上的"收件人"空格 allowed tools allowed tools • • 允许命令使用的工具列表 允许命令使用的工具列表 工具箱（限定可用的工具） 工具箱（限定可用的工具） 命令作用域 命令作用域 Command Scope Command Scope 命令生效的范围（项目级/用户级） 命令生效的范围（项目级/用户级） 门禁卡（有的只能开一个门，有的能开所有门） 门禁卡（有的只能开一个门，有的能开所有门） 命令命名空间 Namespace 命令的分组前缀 文件夹分类（/dev:xxx、/test:xxx） 补充说明：小白必看的几个概念 1. YAML格式是什么？ YAML是一种简单的配置文件格式，用"键: 值"的形式记录信息： 生活类比：YAML就像你的个人简历表格，"姓名: 张三"这种格式，人能看懂，电脑也能读懂。 2. 符号是什么？ （波浪号）是你的"用户主目录"的简写： • Windows： = C:\Users\你的用户名（比如 C:\Users\admin） • macOS： = /Users/你的用户名 • Linux： = /home/你的用户名 示例： /.claude/commands/ 的意思是： • Windows → C:\Users\admin\.claude\commands\ • macOS → /Users/laojin/.claude/commands/ 3. heredoc语法是什么？ heredoc是一种"多行文本写入"的语法，可以一次性把多行内容写入文件，不用一行一行写。 ⚠️ 重要提醒：heredoc是在PowerShell/Bash终端里用的，不是在Claude Code对话框里用的！ 如果你已经在Claude Code里，根本不需要学heredoc，直接说人话让Claude帮你创建文件就行： Claude Code会自动帮你创建文件夹和文件！ PowerShell终端版本（在Windows PowerShell窗口里用）： Bash终端版本（在macOS/Linux终端里用）： 生活类比：heredoc就像"复制粘贴"——把一大段文字一次性塞进文件里。 小技巧：在Claude Code对话框里换行用 Shift + Enter，按 Enter 会直接发送消息。 第一部分：Commands简介 1.1 什么是Slash命令 一句话理解：Slash命令就是Claude Code的"快捷方式"，输入 /命令名就能触发预设的操作。 生活类比： • 没有Slash命令：每次点外卖都要重新输入地址、选择口味、备注 • 有Slash命令：保存一个"我的常用订单"，一键下单 核心概念（官方文档验证）： 1.2 命令的三大类型 Claude Code的命令分为三大类： 类型 来源 存放位置 特点 内置命令 Claude Code官方 程序内部 不可修改，核心功能 兼容自定义命令 你自己创建 .claude/commands/ 适合旧项目和轻量 prompt 包装 用户级兼容命令 你自己创建（全局） /.claude/commands/ 所有项目共享，偏个人习惯 Skills 工作流 你自己创建 .claude/skills/ / /.claude/skills/ 当前官方推荐的自定义能力形态 类型 类型 来源 来源 存放位置 存放位置 特点 特点 内置命令 内置命令 Claude Code官方 Claude Code官方 程序内部 程序内部 不可修改，核心功能 不可修改，核心功能 兼容自定义命令 兼容自定义命令 你自己创建 你自己创建 .claude/commands/ .claude/commands/ 适合旧项目和轻量 prompt 包装 适合旧项目和轻量 prompt 包装 用户级兼容命令 用户级兼容命令 你自己创建（全局） 你自己创建（全局） /.claude/commands/ /.claude/commands/ 所有项目共享，偏个人习惯 所有项目共享，偏个人习惯 Skills 工作流 Skills 工作流 你自己创建 你自己创建 .claude/skills/ / /.claude/skills/ .claude/skills/ / /.claude/skills/ 当前官方推荐的自定义能力形态 当前官方推荐的自定义能力形态 命令来源决策树： 1.3 为什么要学Commands 没有Commands之前： 有了Commands之后： Commands的核心价值： 对比维度 手动输入 使用Commands 效率 每次重复输入 一次配置，永久使用 一致性 每次可能遗漏要求 标准化执行 可复用 无法分享 团队共享、社区贡献 可维护 分散在聊天记录 集中管理、版本控制 对比维度 对比维度 手动输入 手动输入 使用Commands 使用Commands 效率 效率 每次重复输入 每次重复输入 一次配置，永久使用 一次配置，永久使用 一致性 一致性 每次可能遗漏要求 每次可能遗漏要求 标准化执行 标准化执行 可复用 可复用 无法分享 无法分享 团队共享、社区贡献 团队共享、社区贡献 可维护 可维护 分散在聊天记录 分散在聊天记录 集中管理、版本控制 集中管理、版本控制 第二部分：5分钟快速开始 本节目的：用最快速度创建第一个自定义命令，让你立即看到效果！ 预计时间：5分钟 2.1 创建第一个自定义命令 步骤1：创建命令目录 Windows系统（PowerShell）： macOS/Linux系统： 验证是否成功： 步骤2：创建最简单的命令文件 创建文件 .claude/commands/hello.md： 💡 你有两种选择： 选择A：在Claude Code对话框里说人话（推荐新手） （换行用 Shift + Enter，最后按 Enter 发送） 选择B：在终端里用命令行（熟悉命令行的用户） 见下方PowerShell/Bash代码 Windows（PowerShell终端）： macOS/Linux（终端）： 步骤3：测试命令 启动Claude Code并测试： 在交互模式中输入： 预期结果： 再测试无参数情况： 预期结果： 2.2 恭喜完成第一个命令！ 你刚才完成了什么？ 1. 创建了命令目录 .claude/commands/ 2. 编写了第一个命令文件 hello.md 3. 使用 $ARGUMENTS 接收参数 4. 成功运行命令并看到效果 核心要点回顾： 第三部分：内置命令速查 本节说明：内置命令的详细用法已在「02 基础使用完整指南」第四部分讲解过，这里提供速查表方便查阅。 详细教程：请回顾「02 基础使用完整指南.md」→ 第四部分：Slash命令大全 版本校准（2026 04）：当前官方 Commands Reference 没有 /todos。Claude 的待办追踪是内部 TodoWrite 工具 / SDK 事件；后台任务管理使用 /tasks。 内置命令速查表 分类 命令 功能 常用场景 重要 会话管理 /clear 清空对话历史 开始新任务 ⭐ /compact 智能压缩对话 Token超60%时 ⭐ /resume 恢复历史会话 继续之前的工作 ⭐ /export 导出对话记录 保存重要对话 /rename 重命名会话 整理会话列表 /branch 创建会话分支 探索不同方案 /btw 提旁路问题 不污染主上下文 /side 临时旁路会话 快速追问 /teleport 拉取 Web 会话到终端 Web/CLI 接力 上下文控制 /context 查看Token使用 监控上下文 ⭐ /cost 查看费用与用量（v2.1.92+ 订阅用户含 per model / cache hit，见 release） 成本控制 /model 切换AI模型 按需选模型 ⭐ /effort 推理深度控制 调节AI思考深度 ⭐ 分类 分类 命令 命令 功能 功能 常用场景 常用场景 重要 重要 会话管理 会话管理 /clear /clear 清空对话历史 清空对话历史 开始新任务 开始新任务 ⭐ ⭐ /compact /compact 智能压缩对话 智能压缩对话 Token超60%时 Token超60%时 ⭐ ⭐ /resume /resume 恢复历史会话 恢复历史会话 继续之前的工作 继续之前的工作 ⭐ ⭐ /export /export 导