Slash Commands标准化实践

发布时间:2026/7/9 7:21:25
Slash Commands标准化实践 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. MCPModel 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:commentsMCP 服务器配置模板服务器类型配置文件功能描述GitHubgithub.yaml访问仓库、PR、Issues数据库database.yaml连接 PostgreSQL/MySQL文件系统filesystem.yaml本地文件操作Slackslack.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/checkoutv4 - 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-artifactv4 with: name: claude-review path: review-report.json8. 质量保障与版本控制项目采用工程化的质量保障体系 检查项工具目的Markdown 格式markdownlint-cli确保配置文件格式规范链接验证自定义 Python 脚本检查相对链接和锚点Mermaid 语法自定义 Python 脚本验证架构图可解析EPUB 构建构建脚本支持离线文档生成通过上述工程化实践Claude Code 的各个技术模块能够以标准化、可复用、可维护的方式集成到开发工作流中实现从简单命令到复杂多智能体协作的平滑过渡。参考来源GitHub热榜开源项目Claude Code 10模块系统学习指南GitHub热榜开源项目Claude Code 10模块系统学习指南重磅更新Claude Code 现在支持插件啦Claude Code--Feishu-Skill-demo14.8k starsClaude Code 用了白用这个开源指南让你解锁 90% 被浪费的能力GitHub_Trending/cl/claude-plugins-official中的自动化推荐插件提升工作效率的完整指南