用途
本技能用于指导创建自定义 Claude Code 斜杠命令。斜杠命令是以 Markdown 文件形式保存的可复用提示词，可通过 /command-name 语法调用，适合需要显式触发的常用提示词。
主要能力
命令作用域
- 项目级：存放于
.claude/commands/，可通过 git 与团队共享，在帮助列表中标记为 "(project)"。 - 个人级：存放于
~/.claude/commands/，跨所有项目可用，在帮助列表中标记为 "(user)"。
参数处理
- 无参数：适合不需要输入的简单命令。
$ARGUMENTS：捕获传入的全部内容。- 位置参数
$1、$2、$3：按位置访问特定参数，可为缺失参数提供默认值，适合多参数命令。 - 可组合使用位置参数与全量参数。
Frontmatter 配置字段
allowed-tools：限制 Claude 可使用的工具，例如Read, Write, Edit, Bash或Bash(git add:*), Bash(git status:*)。argument-hint：在自动补全中展示预期参数。description：命令简介（覆盖首行）。model：为该命令指定模型。disable-model-invocation：阻止通过 SlashCommand 工具自动调用。
进阶特性
- 使用
@引用文件内容。 - 使用
!执行 Bash 命令并纳入输出（需配置 allowed-tools）。 - 在命令内容中包含关键词以触发扩展思考。
- 用子目录实现命名空间（影响描述，不改变调用名）。
使用方式
创建工作流：识别用途 → 选择作用域 → 选取名称（不含 .md 扩展名的描述性文件名）→ 设计参数 → 添加 frontmatter → 编写提示词 → 测试调用。
调用语法：/command-name [arguments]，命令名来自去掉 .md 扩展名的文件名。
示例（原文代码）：
创建项目命令：
echo "Review this code for security vulnerabilities" > .claude/commands/security-review.md
创建个人命令：
echo "Explain this code in simple terms" > ~/.claude/commands/explain.md
示例命令文件（.claude/commands/review.md）：
---
description: Comprehensive code review for quality and security
---
Review this code for:
- Code quality and maintainability
- Security vulnerabilities
- Performance optimizations
- Best practices adherence
- Potential bugs or edge cases
Provide specific, actionable feedback with code examples.
带参数的示例（.claude/commands/fix-issue.md）：
---
argument-hint: <issue-number> [priority]
description: Fix GitHub issue following coding standards
---
Fix issue #$1 following our coding standards.
Priority: $2
Steps:
1. Read the issue details from GitHub
2. Analyze the problem and root cause
3. Implement the fix with tests
4. Update documentation if needed
5. Create a commit with proper message format
测试方式：在 Claude Code 中执行 /help 查看命令是否出现，再用不同参数组合调用验证提示词展开与参数替换。
适用场景
资料中给出的示例包括：代码审查（/review）、问题修复（/fix-issue）、PR 创建（/create-pr）、测试运行（/test）、文档生成（/document）、代码优化（/optimize）、多参数 PR 审查（/review-pr）、Git 工作流（/git-flow）、数据库查询优化（/optimize-query）、GitHub issue 创建（/create-issue）等。也可按功能领域、复杂度或团队角色组织到子目录中。
斜杠命令与技能的选择
斜杠命令：需显式调用、快速常用、简单提示词片段、单文件能力、手动控制执行，适合代码审查、快速解释、频繁操作与团队标准化提示词。 技能：基于上下文自动发现、由 Claude 决定调用、复杂多步工作流、多文件结构，适合 PDF 处理、API 文档生成等场景。两者可以共存。
最佳实践要点
使用 kebab-case 描述性文件名；文件位置与作用域匹配；description 清晰简洁；用 argument-hint 记录参数；提示词具体可执行；@ 文件引用路径正确；! Bash 命令配置合适的工具限制；模型选择匹配复杂度；用多种参数组合测试；相关命令用子目录组织；不在命令中放置敏感数据。
常见问题
命令未出现：检查 .md 扩展名、文件位置，重启 Claude Code。参数未替换：检查 $ARGUMENTS、$1、$2 语法与额外空格。文件引用不生效：确认路径相对项目根目录、文件存在且可读、存在 @ 前缀。Bash 命令失败：在 frontmatter 添加 allowed-tools: Bash，确认命令可独立运行，检查工具限制模式。描述不显示：添加 description 字段，确保 YAML 有效。
限制
资料未提供本技能的收费、价格、平台支持范围与效果数据，暂未提供。