古法编程

Claude HowTo 教程指南提供了 8 个即插即用的生产级斜杠命令模板。你只需一键安装，即可获得从代码性能分析、PR 准备到安全提交和 CI/CD 自动化的完整工作流。本文将逐一解析这些模板的核心功能、安全检查逻辑和 allowed-tools 配置。

8 个实战斜杠命令模板：从代码优化到 CI/CD 自动化

在 Claude Code 中，斜杠命令（Slash Commands）是控制 AI 行为的快捷方式。除了 60 多个内置命令，你还可以创建自定义命令来固化开发流程。Claude HowTo 教程指南提供了 8 个精心设计的模板，它们可以直接复制到你的项目中，立刻提升开发效率。

一键安装与部署

所有模板都位于 01-slash-commands 目录中。推荐的安装方式是将它们作为“技能”（Skills）安装，这是当前的推荐做法。在终端中运行以下命令即可一键部署：

# 创建技能目录
mkdir -p .claude/skills

# 批量安装所有模板
for cmd in optimize pr commit push-all generate-api-docs setup-ci-cd unit-test-expand doc-refactor; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

安装完成后，在 Claude Code 中输入 / 就能看到这些命令。你也可以选择将它们作为“传统命令”安装到 .claude/commands/ 目录，技能和命令文件同名时，技能版本会优先执行。更多关于斜杠命令体系的详情，可查阅 Claude Code 斜杠命令全解析。

模板 1：/optimize — 代码性能优化分析师

这个命令不是进行泛泛的代码改进，而是专注于找出性能瓶颈和潜在问题。它基于一个固定的分析优先级清单工作。

使用方法：

/optimize
[粘贴你的代码]

核心工作流： 它会按照以下顺序检查代码：

  1. 性能瓶颈：识别 O(n²) 操作、低效循环。
  2. 内存泄漏：查找未释放的资源、循环引用。
  3. 算法改进：建议更好的算法或数据结构。
  4. 缓存机会：识别重复计算。
  5. 并发问题：找出竞态条件或线程问题。

输出结果会按照严重程度（Critical/High/Medium/Low）分类，精确指出问题位置，并附带修复建议和代码示例。

模板 2：/pr — Pull Request 准备清单

这是提交 PR 前的终极检查清单。它强制执行一个从代码质量到提交信息的标准化流程。

使用方法：

/pr

核心检查清单：

  1. 运行 Lint：执行 prettier --write . 进行代码格式化。
  2. 运行测试：执行 npm test 确保测试通过。
  3. 审查变更：查看 git diff HEAD 的详细改动。
  4. 暂存文件：执行 git add .。
  5. 规范提交：按照约定式提交（Conventional Commits）格式创建提交信息。
  6. 生成摘要：自动产出包含变更内容、原因、测试情况和潜在影响的 PR 摘要。

此命令的关键在于其明确的 allowed-tools 配置，它仅允许执行 git add、git status、git diff、npm test 和 npm run lint，确保了操作的安全性和专注性。

模板 3：/commit — 带上下文的智能提交

与简单的 git commit 不同，这个命令会先自动收集仓库的当前状态作为上下文。

使用方法：

/commit [可选的提交信息]

工作原理： 命令模板中定义了动态上下文收集：

  • 当前 Git 状态：!git status``
  • 当前工作区差异：!git diff HEAD``
  • 当前分支：!git branch --show-current``
  • 最近提交记录：!git log --oneline -10``

Claude 会基于这些丰富的上下文信息生成一个符合规范的提交信息。如果你通过 $ARGUMENTS 传入了信息，则会使用你提供的内容。

模板 4：/push-all — 安全的全局推送（高危操作）

这是一个功能强大但需要谨慎使用的命令，它执行“暂存所有、提交、推送”一条龙服务。其安全检查逻辑是精髓所在。

使用方法：

/push-all

安全检查与确认流程：

  1. 并行分析：运行 git status、git diff --stat 和 git log -1 --oneline。
  2. 强制安全拦截（有以下任一情况则停止并警告）：
    • 机密文件：.env*, *.key, *.pem, credentials.json 等。
    • 真实 API 密钥：检测 *_API_KEY, *_SECRET 等变量，通过正则匹配区分真实值（如 sk-proj-xxxxx）和占位符（如 your-api-key-here）。
    • 大文件：超过 10MB 且未使用 Git LFS。
    • 构建产物：node_modules/, dist/, __pycache__/ 等。
  3. 请求确认：展示变更摘要（文件数、插入/删除行数）和安全检查结果，并等待用户明确输入“yes” 才继续。
  4. 执行提交与推送：生成规范提交信息，执行 git commit 和 git push。

这个命令的 allowed-tools 配置了从 git add 到 git pull 的完整权限链，是其能力的基础。

模板 5：/generate-api-docs — API 文档生成器

自动化生成 API 文档，保持文档与代码同步。

使用方法：

/generate-api-docs

生成逻辑：

  1. 扫描 /src/api/ 目录下所有文件。
  2. 提取函数签名和 JSDoc 注释。
  3. 按端点或模块组织。
  4. 生成包含 curl 示例和 TypeScript 类型的 Markdown 文档，输出到 /docs/api.md。

模板 6：/setup-ci-cd — CI/CD 流水线配置

为项目快速搭建起一套现代化的 CI/CD 质量门禁。

使用方法：

/setup-ci-cd

自动化配置流程：

  1. 分析项目：自动检测语言、框架、构建系统和现有工具。
  2. 配置预提交钩子：根据项目类型设置格式化、Lint、安全扫描和类型检查等工具。
  3. 创建 GitHub Actions 工作流：在 .github/workflows/ 下生成配置，实现推送/PR 时的自动化检查、多版本构建和测试。
  4. 验证流水线：建议本地测试并创建测试 PR 以确保所有检查通过。

模板 7：/unit-test-expand — 测试覆盖率扩展

智能识别代码中未测试的分支和边界情况，自动补充测试用例。

使用方法：

/unit-test-expand

扩展策略：

  1. 运行覆盖率报告，识别低覆盖区域。
  2. 审查代码逻辑分支、错误路径和边界条件。
  3. 使用项目现有的测试框架（如 Jest, pytest）编写测试。
  4. 专门针对错误处理、边界值、空输入和状态转换等场景设计测试。
  5. 重新运行覆盖率验证改进效果。

模板 8：/doc-refactor — 文档结构重构

对项目文档进行系统性整理，使其更清晰、更易访问。

使用方法：

/doc-refactor

重构步骤：

  1. 分析项目类型（库、API、Web 应用等）和目标用户。
  2. 将技术文档集中到 docs/ 目录。
  3. 精简根 README.md 作为入口。
  4. 为模块/组件添加 README 文件。
  5. 按架构、API 参考、部署指南等分类组织文档。
  6. 为所有架构和流程图使用 Mermaid 语法。

总结

这 8 个模板覆盖了从代码编写到部署上线的核心开发环节。它们通过标准化的命令和检查清单，将最佳实践固化到日常工作中。值得注意的是，随着 Claude Code 的发展，自定义命令已被合并到“技能”（Skills）体系中，后者提供了目录结构、自动调用等更强大的特性。你可以通过 /lesson-quiz 或 /self-assessment 来评估自己对这些功能的掌握程度。

FAQ

Q: 我在 .claude/commands/ 和 .claude/skills/ 下有同名的命令文件，会执行哪个？ A: 技能（Skills）版本会优先执行。这是推荐的做法，因为技能支持更复杂的目录结构和自动调用功能。

Q: 如何创建一个只允许用户手动调用，不让 Claude 自动触发的命令？ A: 在技能文件的 YAML 前置元数据中，设置 disable-model-invocation: true。这适用于像生产环境部署这类有副作用的操作。

Q: /push-all 命令检测到大文件后，我该怎么办？ A: 命令会中止推送并发出警告。你应该使用 Git LFS 来管理大文件，或者将不需要跟踪的文件添加到 .gitignore 中，然后重新运行命令。