Slash Commands标准化实践

Z_changcun

222人浏览 · 2026-07-08 14:46:52

Z_changcun · 2026-07-08 14:46:52 发布

Claude Code 的核心技术模块通过标准化配置、模块化封装和自动化集成实现工程化实践。以下是各模块的具体实践方法：

1. Slash Commands：标准化命令模板

Slash Commands 通过 .claude/commands/ 目录下的 Markdown 文件定义，采用统一的结构化格式。

# /optimize
优化当前代码，遵循项目编码规范。

## 参数 `--aggressive`: 应用激进优化 `--safe`: 仅应用安全重构

## 示例
`/optimize --safe` 安全优化当前文件

工程化实践要点：

实践方面	具体实现
目录结构	所有命令文件集中存储在 `.claude/commands/` 目录
模板复用	提供8个可直接复用的命令模板（如 `/pr`、`/generate-api-docs`）
参数标准化	使用 `## 参数` 部分定义命令行参数
示例文档	每个命令包含 `## 示例` 部分展示用法

2. Hooks：事件驱动自动化

Hooks 通过 .claude/hooks/ 目录下的脚本文件实现，支持多种事件触发。

#!/bin/bash
# .claude/hooks/pre-commit.sh
# 在代码提交前自动运行安全检查

echo "Running security scan..."
# 安全检查逻辑
if [ -f "security_issues.txt" ]; then
    echo "Security issues found!"
    exit 1
fi

支持的 Hook 类型：

Hook 类型	触发时机	示例用途
`pre-commit`	提交代码前	代码格式化、安全检查
`post-write`	文件写入后	自动生成文档、触发测试
`pre-review`	代码审查前	收集代码指标
`post-review`	代码审查后	生成审查报告

3. MCP（Model Context Protocol）：外部服务集成

MCP 通过配置文件连接外部服务，支持多种协议和认证方式。

# .claude/mcp/servers/github.yaml
name: github-mcp
type: github
config:
  token: ${GITHUB_TOKEN}
  repos:
    - owner: your-org
      name: your-repo permissions:
    - read:issues - read:pull_requests
 write:comments

MCP 服务器配置模板：

服务器类型	配置文件	功能描述
GitHub	`github.yaml`	访问仓库、PR、Issues
数据库	`database.yaml`	连接 PostgreSQL/MySQL
文件系统	`filesystem.yaml`	本地文件操作
Slack	`slack.yaml`	消息通知集成

4. Subagents：专业化智能体分工

Subagents 在 .claude/agents/ 目录下定义，每个智能体有明确的角色和工具集。

# code-reviewer专注于代码质量审查的智能体。

## 角色 资深代码审查专家
专注于代码质量和设计模式

## 工具
静态代码分析
复杂度评估 设计模式识别

## 约束 只读模式：不能修改代码 最大响应长度：1000字符

预定义 Subagents 模板：

Subagent	专业领域	典型应用场景
`code-reviewer`	代码质量审查	PR 审查、代码规范检查
`test-engineer`	测试策略	测试用例生成、覆盖率分析
`secure-reviewer`	安全审计	漏洞扫描、安全合规检查
`documentation-specialist`	文档生成	API 文档、用户手册

5. 模块协同工作流示例

以下是各模块协同工作的自动化代码审查流水线：

# 自动化代码审查工作流
用户输入: /review-pr

工作流执行:
1. Slash Command 触发 →加载 `/review-pr` 命令定义
2. Memory 加载 → 读取项目 CLAUDE.md 中的编码规范
3. MCP 调用 → 通过 GitHub MCP 获取 PR 代码变更
4. Subagents 分工:
 code-reviewer: 分析代码质量 - test-engineer: 评估测试策略
5. Hooks 触发 → post-review 生成审查报告
6. 结果整合 → 返回综合审查建议

6.工程化配置管理

采用分层配置体系确保可维护性：

#项目级配置结构
.claude/
├── commands/          # Slash Commands│   ├── optimize.md
│   ├── review-pr.md
│   └── generate-docs.md
├── agents/            # Subagents
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   └── secure-reviewer.md
├── hooks/             #自动化脚本
│   ├── pre-commit.sh
│   ├── post-write.py
│ └── security-scan.sh
├── mcp/               #外部服务连接
│   ├── servers/
│ └── config/
└── skills/            # 专业技能 ├── code-review-specialist/
    └── brand-voice/

7. CI/CD 集成实践

Claude Code 支持 Headless Mode 与 CI/CD 流水线集成：

# GitHub Actions 集成示例
name: Code Review Automation
on: [pull_request]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4 - name: Run Claude Code Review
        run: |
          claude -p --output-format json \
            "review the code changes in this PR" \
            > review-report.json - name: Upload Review Report uses: actions/upload-artifact@v4 with:
          name: claude-review path: review-report.json

8. 质量保障与版本控制

项目采用工程化的质量保障体系：

检查项	工具	目的
Markdown 格式	markdownlint-cli	确保配置文件格式规范
链接验证	自定义 Python 脚本	检查相对链接和锚点
Mermaid 语法	自定义 Python 脚本	验证架构图可解析
EPUB 构建	构建脚本	支持离线文档生成