Claude Code 自定义 Slash 命令 — .claude/commands/ 目录与 $ARGUMENTS

.claude/
└── commands/
    ├── review.md           # /review 命令
    ├── test.md             # /test 命令
    ├── deploy.md           # /deploy 命令
    ├── docs.md             # /docs 命令
    └── custom/
        ├── security-audit.md
        └── performance-check.md

# 创建命令目录
mkdir -p .claude/commands

# 创建简单的 hello 命令
cat > .claude/commands/hello.md << 'EOF'
# 命令: /hello

## 描述
向用户问好并显示当前项目信息。

## 执行
1. 输出问候语
2. 显示当前项目名称
3. 显示当前 Git 分支
4. 显示 Claude Code 版本

## 输出格式
以友好的格式展示信息。
EOF

启动流程:
1. 扫描 .claude/commands/ 目录
2. 读取所有 .md 文件
3. 解析命令定义（# 命令: /xxx）
4. 注册到命令列表
5. 在 /help 中显示

# 在交互模式中
/help                    # 显示所有命令，包括自定义命令
/help /hello             # 显示特定命令的帮助

# 列出命令文件
ls -la .claude/commands/

# 验证命令格式
claude commands validate .claude/commands/hello.md

# 命令: /command-name

## 描述
[命令的简短描述，出现在 /help 列表中]

## 参数
[参数说明，可选]
- $1: 第一个参数
- $2: 第二个参数
- --flag: 标志说明

## 执行
[命令执行步骤，Claude 将按照这些步骤操作]

1. 步骤一
2. 步骤二
3. 步骤三

## 输出
[期望的输出格式]

## 约束
[执行约束，可选]
- 不要修改生产数据库
- 仅处理 .py 文件

# 命令: /deploy

## 描述
部署应用到目标环境

## 元数据
- 版本: 1.0.0
- 作者: 开发团队
- 最后更新: 2024-01-15
- 依赖: /test, /build
- 标签: deployment, production

## 参数
- $1: 目标环境 (staging/production)
- $2: 版本号 (可选，默认 latest)

## 执行
...

# 命令: /report

## 描述
生成项目报告

## 执行
生成以下报告：

### 项目概览
项目名称: $PROJECT_NAME
当前分支: $BRANCH
最后提交: $LAST_COMMIT

### 代码统计
$(git log --oneline | wc -l) 次提交
$(find . -name "*.py" | wc -l) 个 Python 文件

### 测试结果
$(pytest --tb=no -q 2>/dev/null || echo "测试未运行")

# 命令: /search

## 描述
在项目中搜索代码

## 参数
- $ARGUMENTS: 搜索关键词

## 执行
搜索关键词: $ARGUMENTS

1. 使用 grep 搜索整个项目
2. 按文件类型分组结果
3. 统计匹配数量
4. 展示前 20 个匹配

# 使用示例
/search "def login"
/search "class.*Exception" --include "*.py"

# 命令: /generate

## 描述
生成代码文件

## 参数
- $1: 文件类型 (model/view/controller)
- $2: 文件名称
- $3: 输出目录 (可选，默认 src/)

## 执行
文件类型: $1
文件名称: $2
输出目录: ${3:-src/}

1. 根据类型选择模板
2. 生成文件到指定目录
3. 更新相关导入

# 使用示例
/generate model User
/generate controller auth src/api/
/generate view dashboard

# 命令: /deploy

## 描述
部署应用

## 参数
- $1: 环境 (必须: staging 或 production)

## 执行
环境: $1

⚠️ 参数验证:
如果 $1 不是 "staging" 且不是 "production":
  输出错误: "无效的环境: $1。必须是 staging 或 production"
  停止执行

继续部署流程...

# 命令: /test

## 描述
运行测试

## 参数
- $1: 测试类型 (unit/integration/all)，默认: all
- $2: 是否生成报告 (yes/no)，默认: no
- $3: 覆盖率阈值 (数字)，默认: 80

## 执行
测试类型: ${1:-all}
生成报告: ${2:-no}
覆盖率阈值: ${3:-80}

1. 运行 ${1:-all} 测试
2. 如果 ${2:-no} 为 yes，生成报告
3. 检查覆盖率是否 >= ${3:-80}%

# 命令: /pr-info

## 描述
显示当前 PR 信息

## 执行
分支: $BRANCH
目标分支: $TARGET_BRANCH
提交数: $(git rev-list --count $TARGET_BRANCH..HEAD)
变更文件: $(git diff --name-only $TARGET_BRANCH..HEAD | wc -l)

PR 变更摘要:
$(git diff --stat $TARGET_BRANCH..HEAD)

# 命令: /env-info

## 描述
显示环境信息

## 执行
Python: $(python3 --version 2>&1)
Node: $(node --version 2>&1)
Git: $(git --version 2>&1)
OS: $(uname -s)
Path: $PATH

# 命令: /full-review

## 描述
执行完整代码审查流程

## 执行
1. 运行 /lint 命令检查代码质量
2. 运行 /test 命令执行测试
3. 运行 /review 命令审查代码
4. 汇总所有结果生成报告
5. 如果有严重问题，阻止提交

# 命令: /smart-deploy

## 描述
智能部署（通过所有检查后部署）

## 执行
1. 运行 /test all yes
2. 如果测试失败:
   - 输出错误信息
   - 停止执行
3. 如果测试通过:
   - 运行 /lint
   - 如果 lint 通过:
     - 运行 /deploy staging
     - 等待确认
     - 如果用户确认，运行 /deploy production
   - 如果 lint 失败:
     - 输出 lint 问题
     - 停止执行

# 命令: /parallel-check

## 描述
并行执行多项检查

## 执行
同时执行以下检查：
1. /lint — 代码质量检查
2. /test unit — 单元测试
3. /security — 安全扫描
4. /performance — 性能基准

汇总所有检查结果并生成综合报告。

# 将自定义命令纳入版本控制
git add .claude/commands/
git commit -m "feat: 添加团队自定义命令"

# 排除个人命令
echo ".claude/commands/personal/" >> .gitignore

# 创建命令库
mkdir -p claude-command-library/
cd claude-command-library/

# 按类别组织
mkdir -p review/ test/ deploy/ docs/ security/

# 复制常用命令
cp ../project/.claude/commands/review.md review/standard.md
cp ../project/.claude/commands/test.md test/comprehensive.md

# 创建索引
cat > INDEX.md << 'EOF'
# Claude Code 命令库

## 代码审查
- [standard](review/standard.md) — 标准代码审查
- [security](review/security.md) — 安全审查
- [performance](review/performance.md) — 性能审查

## 测试
- [unit](test/unit.md) — 单元测试
- [integration](test/integration.md) — 集成测试
- [comprehensive](test/comprehensive.md) — 完整测试
EOF

#!/bin/bash
# install-commands.sh — 安装团队命令库

REPO_URL="https://github.com/team/claude-commands"
COMMANDS_DIR=".claude/commands"

echo "📦 安装团队 Claude Code 命令库..."

# 克隆或更新命令库
if [ ! -d "claude-command-library" ]; then
  git clone $REPO_URL claude-command-library
else
  cd claude-command-library && git pull && cd ..
fi

# 创建命令目录
mkdir -p $COMMANDS_DIR

# 安装命令
cp claude-command-library/review/*.md $COMMANDS_DIR/
cp claude-command-library/test/*.md $COMMANDS_DIR/
cp claude-command-library/deploy/*.md $COMMANDS_DIR/

echo "✅ 命令安装完成"
echo "📋 已安装命令:"
ls $COMMANDS_DIR/

<!-- .claude/commands/CHANGELOG.md -->

# 命令变更日志

## v1.2.0 (2024-01-15)
- 新增 /security-audit 命令
- 改进 /review 命令，支持自定义规则
- 修复 /test 命令参数解析问题

## v1.1.0 (2024-01-10)
- 新增 /deploy 命令
- 改进 /lint 命令，支持多语言

## v1.0.0 (2024-01-01)
- 初始版本
- /review, /test, /lint, /docs 命令

# 命令: /pr-review

## 描述
自动化 Pull Request 审查

## 参数
- $1: PR 编号或 URL

## 执行
PR: $1

1. 获取 PR 变更文件
2. 对每个变更文件执行:
   a. 审查代码变更
   b. 检查安全问题
   c. 检查性能影响
3. 生成审查报告:
   - 变更概览
   - 问题列表（按严重程度）
   - 改进建议
   - 总体评分
4. 如果评分 >= 8，自动 approve
5. 如果评分 < 8，标记需要修改

# 命令: /generate-docs

## 描述
一键生成项目文档

## 参数
- $1: 文档类型 (api/user/developer)，默认: all
- $2: 输出格式 (markdown/html/pdf)，默认: markdown

## 执行
文档类型: ${1:-all}
输出格式: ${2:-markdown}

1. 扫描项目代码
2. 提取函数/类签名
3. 解析 docstring
4. 生成文档结构
5. 输出到 docs/ 目录
6. 更新文档索引

# 命令: /security-audit

## 描述
全面安全审计

## 执行
1. 依赖安全检查
   - 运行 npm audit / pip audit
   - 分析已知漏洞

2. 代码安全扫描
   - 检查硬编码密钥
   - 检查 SQL 注入风险
   - 检查 XSS 风险
   - 检查路径遍历

3. 配置安全检查
   - 检查 .env 文件是否提交
   - 检查调试模式是否开启
   - 检查 CORS 配置

4. 生成安全报告
   - 漏洞列表
   - 风险评级
   - 修复建议
   - 合规检查