英文原文正文为项目原始 README(英文),本站后续会翻译为中文,当前仅剔除图片与无关章节并统一排版。
Claude 代码斜杠命令
[!重要]
此仓库已归档,不再维护。Claude 代码现在作为插件的一部分提供命令,因此新的工作发生在 Agentic 插件市场,它将代理、技能和命令打包为可单独安装的插件。
要在 Claude Code 的市场中开始使用,请运行 /plugin marketplace add wshobson/agents,然后使用 /plugin install <name> 安装所需的插件。
一个为 Claude Code 提供的综合生产就绪斜杠命令集合,提供智能自动化和多代理编排功能,适用于现代软件开发。
概览
此存储库提供 57 个可用于生产的斜杠命令(15 个工作流,42 个工具),通过以下方式扩展 Claude Code 的功能:
- 工作流:多代理协调系统,用于跨不同领域协调复杂的多步骤操作
- 工具:用于专注开发任务的专用单功能实用程序
系统要求
安装
注意:此仓库使用斜杠命令模式。对于更现代的方法,请考虑插件市场,它通过更简洁的插件架构提供类似功能。
斜杠命令(此仓库)
# Navigate to Claude configuration directory
cd ~/.claude
# Clone the commands repository
git clone https://github.com/wshobson/commands.git
插件市场(替代)
# Add the plugin marketplace
/plugin marketplace add https://github.com/wshobson/agents
# Install plugin collections
/plugin install claude-code-essentials
可用的集合包括:claude-code-essentials、full-stack-development、security-hardening、data-ml-pipeline、infrastructure-devops,等等。
命令调用
命令被组织在 tools/ 和 workflows/ 目录中,并使用目录前缀调用:
# Workflow invocation
/workflows:feature-development implement OAuth2 authentication
# Tool invocation
/tools:security-scan perform vulnerability assessment
# Multiple argument example
/tools:api-scaffold create user management endpoints with RBAC
替代设置(无前缀)
要在没有目录前缀的情况下调用命令,请将文件复制到根目录:
cp tools/*.md .
cp workflows/*.md .
# Then invoke directly
/api-scaffold create REST endpoints
/feature-development implement payment system
命令架构
工作流程(15 个命令)
工作流程实现复杂跨领域任务的多代理编排模式。每个工作流程分析需求,分配给专业代理,并协调多个子系统的执行。
核心开发工作流程
| 命令 |
目的 |
代理协调 |
feature-development |
端到端功能实现 |
后端、前端、测试、部署 |
full-review |
多角度代码分析 |
架构、安全、性能、质量 |
smart-fix |
智能问题解决 |
根据问题类型动态选择代理 |
tdd-cycle |
测试驱动开发编排 |
测试编写者、实现者、重构专家 |
流程自动化工作流
| 命令 |
目的 |
范围 |
git-workflow |
版本控制流程自动化 |
分支策略、提交规范、PR 模板 |
improve-agent |
代理优化 |
提示工程、性能调优 |
legacy-modernize |
代码库现代化 |
架构迁移、依赖更新、模式重构 |
multi-platform |
跨平台开发 |
Web、移动端、桌面协调 |
workflow-automate |
CI/CD 流水线自动化 |
构建、测试、部署、监控 |
高级编排工作流
| 命令 |
主要关注点 |
专用代理 |
full-stack-feature |
多层实现 |
后端 API、前端 UI、移动端、数据库 |
security-hardening |
安全优先开发 |
威胁建模、漏洞评估、修复 |
data-driven-feature |
由机器学习驱动的功能 |
数据科学, 特征工程, 模型部署 |
performance-optimization |
系统范围优化 |
分析、缓存、查询优化、负载测试 |
incident-response |
生产问题解决 |
诊断、根本原因分析、快速修复部署 |
工具(42条命令)
工具提供针对特定开发操作的专用单功能实用程序。每个工具都针对其领域进行了优化,并具有可用于生产的实现。
人工智能和机器学习(4个工具)
| 命令 |
功能 |
主要特性 |
ai-assistant |
AI 助手实现 |
LLM 集成、对话管理、上下文处理 |
ai-review |
机器学习代码审查 |
模型架构验证、训练流程审查 |
langchain-agent |
LangChain 代理创建 |
RAG 模式、工具集成、内存管理 |
prompt-optimize |
提示工程 |
性能测试、成本优化、质量指标 |
代理协作(3 个工具)
| 命令 |
焦点 |
亮点 |
multi-agent-review |
多视角代码审查 |
架构、安全性和质量评估 |
multi-agent-optimize |
协调性能优化 |
数据库、应用程序和前端调优 |
smart-debug |
辅助调试 |
结合性能感知的根本原因分析升级 |
架构与代码质量(4 个工具)
| 命令 |
目的 |
功能 |
code-explain |
代码文档 |
AST分析,复杂度指标,流程图 |
code-migrate |
迁移自动化 |
框架升级,语言移植,API迁移 |
refactor-clean |
代码改进 |
模式检测,废弃代码移除,结构优化 |
tech-debt |
技术债务评估 |
复杂度分析,风险评分,修复计划 |
数据和数据库(3个工具)
| 命令 |
关注领域 |
技术 |
data-pipeline |
ETL/ELT 架构 |
Apache Spark、Airflow、dbt、流处理平台 |
data-validation |
数据质量 |
模式验证、异常检测、约束检查 |
db-migrate |
数据库迁移 |
架构版本控制、零停机策略、回滚计划 |
运维和基础设施 (5 个工具)
| 命令 |
领域 |
实现 |
deploy-checklist |
部署准备 |
飞行前检查、回滚程序、监控设置 |
docker-optimize |
容器优化 |
多阶段构建、层缓存、体积减小 |
k8s-manifest |
Kubernetes 配置 |
部署、服务、Ingress、自动扩缩、安全策略 |
monitor-setup |
可观测性 |
指标、日志、追踪、告警规则 |
slo-implement |
SLO/SLI 定义 |
错误预算、监控、自动响应 |
测试和开发 (6 个工具)
| 命令 |
测试重点 |
框架支持 |
api-mock |
模拟生成 |
REST, GraphQL, gRPC, WebSocket |
api-scaffold |
端点创建 |
CRUD操作, 认证, 验证 |
test-harness |
测试套件生成 |
单元, 集成, 端到端, 性能 |
tdd-red |
测试优先开发 |
创建失败测试, 边缘情况覆盖 |
tdd-green |
实现 |
通过测试的最少代码 |
tdd-refactor |
代码改进 |
在保持测试通过的同时优化 |
安全与合规(3 个工具)
| 命令 |
安全领域 |
标准 |
accessibility-audit |
WCAG 合规性 |
ARIA、键盘导航、屏幕阅读器支持 |
compliance-check |
法规合规 |
GDPR、HIPAA、SOC2、PCI-DSS |
security-scan |
漏洞评估 |
OWASP、CVE 扫描、依赖性审核 |
调试与分析(4 个工具)
| 命令 |
分析类型 |
输出 |
debug-trace |
运行时分析 |
堆栈跟踪、内存分析、执行路径 |
error-analysis |
错误模式 |
根本原因分析、频率分析、影响评估 |
error-trace |
生产调试 |
日志关联、分布式追踪、错误重现 |
issue |
问题跟踪 |
标准化模板、重现步骤、验收标准 |
依赖和配置管理(3 个工具)
| 命令 |
管理领域 |
功能 |
config-validate |
配置管理 |
架构验证、环境变量、密钥处理 |
deps-audit |
依赖分析 |
安全漏洞、许可证合规性、版本冲突 |
deps-upgrade |
版本管理 |
破坏性变更检测、兼容性测试、回滚支持 |
文档与协作(3 个工具)
| 命令 |
文档类型 |
格式 |
doc-generate |
API 文档 |
OpenAPI, JSDoc, TypeDoc, Sphinx |
pr-enhance |
拉取请求优化 |
描述生成, 检查清单创建, 审查建议 |
standup-notes |
状态报告 |
进度跟踪, 阻塞识别, 下一步 |
操作与上下文(4 个工具)
| 命令 |
操作重点 |
使用案例 |
cost-optimize |
资源优化 |
云支出分析、资源适配、预留容量 |
onboard |
环境设置 |
开发工具、访问配置、文档 |
context-save |
状态持久化 |
架构决策,配置快照 |
context-restore |
状态恢复 |
上下文重载、决策历史、配置恢复 |
使用模式
常见开发场景
功能实现
# Complete feature with multi-agent orchestration
/workflows:feature-development OAuth2 authentication with JWT tokens
# API-first development
/tools:api-scaffold REST endpoints for user management with RBAC
# Test-driven approach
/workflows:tdd-cycle shopping cart with discount calculation logic
调试与性能
# Intelligent issue resolution
/workflows:smart-fix high memory consumption in production workers
# Targeted error analysis
/tools:error-trace investigate Redis connection timeouts
# Performance optimization
/workflows:performance-optimization optimize database query performance
安全与合规
# Security assessment
/tools:security-scan OWASP Top 10 vulnerability scan
# Compliance verification
/tools:compliance-check GDPR data handling requirements
# Security hardening workflow
/workflows:security-hardening implement zero-trust architecture
测试驱动开发
标准TDD流程
# Complete TDD cycle with orchestration
/workflows:tdd-cycle payment processing with Stripe integration
# Manual TDD phases for granular control
/tools:tdd-red create failing tests for order validation
/tools:tdd-green implement minimal order validation logic
/tools:tdd-refactor optimize validation performance
命令组合策略
顺序执行模式
# Feature implementation pipeline
/workflows:feature-development real-time notifications with WebSockets
/tools:security-scan WebSocket implementation vulnerabilities
/workflows:performance-optimization WebSocket connection handling
/tools:deploy-checklist notification service deployment requirements
/tools:k8s-manifest WebSocket service with session affinity
现代化管道
# Legacy system upgrade
/workflows:legacy-modernize migrate monolith to microservices
/tools:deps-audit check dependency vulnerabilities
/tools:deps-upgrade update to latest stable versions
/tools:refactor-clean remove deprecated patterns
/tools:test-harness generate comprehensive test coverage
/tools:docker-optimize create optimized container images
/tools:k8s-manifest deploy with rolling update strategy
命令选择指南
工作流与工具决策矩阵
| 标准 |
使用工作流 |
使用工具 |
| 问题复杂性 |
多领域,跨职能问题 |
单一领域,集中范围 |
| 解决方案清晰度 |
探索性,未定义的方法 |
清晰的实施路径 |
| 代理协调 |
需要多名专家 |
单一专业足够 |
| 实施范围 |
端到端功能 |
特定组件 |
| 控制等级 |
优先自动化编排 |
需要手动控制 |
工作流选择示例
| 需求 |
推荐工作流 |
理由 |
| “构建完整的认证系统” |
/workflows:feature-development |
需要多层实现 |
| “调试生产性能问题” |
/workflows:smart-fix |
根本原因未知,需要分析 |
| “现代化遗留应用” |
/workflows:legacy-modernize |
需要跨技术栈的复杂重构 |
| “实现机器学习驱动功能” |
/workflows:data-driven-feature |
需要数据科学专业知识 |
工具选择示例
| 任务 |
推荐工具 |
输出 |
| "生成 Kubernetes 配置" |
/tools:k8s-manifest |
遵循最佳实践的 YAML 清单 |
| "审核安全漏洞" |
/tools:security-scan |
带修复方案的漏洞报告 |
| "创建 API 文档" |
/tools:doc-generate |
OpenAPI/Swagger 规范 |
| "优化 Docker 镜像" |
/tools:docker-optimize |
多阶段 Dockerfile |
执行最佳实践
上下文优化
- 技术栈规范:包括框架版本、数据库系统、部署目标
- 约束定义:指定性能要求、安全标准、合规需求
- 集成要求:定义外部服务、API、认证方法
- 输出偏好:指明编码标准、测试框架、文档格式
命令链策略
- 渐进增强:从基础工作流开始,用工具逐步优化
- 管道构建:按逻辑顺序链式执行命令以完成整体解决方案
- 迭代优化:使用工具输出作为后续命令的输入
- 并行执行:在可能的情况下同时运行独立工具
性能考虑
- 完整编排的工作流通常需要30-90秒
- 工具执行聚焦操作通常需要5-30秒
- 提前提供详细需求以最小化迭代周期
- 对于多会话项目使用已保存的上下文(
context-save/context-restore)
技术架构
命令结构
每个 slash 命令都是一个具有以下特征的 markdown 文件:
| 组件 |
描述 |
示例 |
| 文件名 |
确定命令名称 |
api-scaffold.md → /tools:api-scaffold |
| 内容 |
执行说明 |
代理提示和编排逻辑 |
| 变量 |
$ARGUMENTS 占位符 |
捕获并处理用户输入 |
| 目录 |
命令类别 |
tools/ 用于工具,workflows/ 用于编排 |
文件组织
~/.claude/commands/
├── workflows/ # Multi-agent orchestration commands
│ ├── feature-development.md
│ ├── smart-fix.md
│ └── ...
├── tools/ # Single-purpose utility commands
│ ├── api-scaffold.md
│ ├── security-scan.md
│ └── ...
└── README.md # This documentation
开发指南
创建新命令
工作流开发
- 文件创建:放在
workflows/ 目录中,并使用描述性命名
- 代理编排:定义多个专家的委派逻辑
- 错误处理:包含回退策略和错误恢复
- 输出协调:指定如何组合代理输出
工具开发
- 文件创建:放在
tools/ 目录中,并使用单一用途命名
- 实现:提供完整的、可生产使用的代码生成
- 框架检测:自动检测并适应项目栈
- 最佳实践:包含安全性、性能和可扩展性考虑
命名规范
- 使用小写并用连字符:
feature-name.md
- 描述性但简洁:
security-scan 而不是 scan
- 明确指示操作:
deps-upgrade 而不是 dependencies
- 保持与现有命令的一致性
故障排除指南
诊断步骤
| 问题 |
原因 |
解决方案 |
| 命令未被识别 |
文件缺失或命名错误 |
确认文件存在于正确目录 |
| 执行慢 |
正常工作流行为 |
工作流协调多个代理(典型时间30-90秒) |
| 输出不完整 |
上下文不足 |
提供技术栈和需求 |
| 集成失败 |
路径或配置问题 |
检查文件路径和依赖 |
性能优化
- 上下文缓存:多会话项目使用
context-save
- 批量操作:将相关任务合并在单个工作流中
- 工具选择:已知问题使用工具,探索性问题使用工作流
- 需求明确:详细规格可减少迭代周期
特色命令实现
测试驱动开发套件
| 命令 |
类型 |
功能 |
tdd-cycle |
工作流程 |
完整的红-绿-重构编排,包含测试覆盖率分析 |
tdd-red |
工具 |
生成失败测试,涵盖边界情况和模拟 |
tdd-green |
工具 |
实现最小功能以通过测试 |
tdd-refactor |
工具 |
在保持测试完整性的同时优化代码 |
框架支持:Jest、Mocha、PyTest、RSpec、JUnit、Go 测试、Rust 测试
安全与基础设施
| 命令 |
专业方向 |
关键特性 |
security-scan |
漏洞检测 |
SAST/DAST 分析, 依赖扫描, 密钥检测 |
docker-optimize |
容器优化 |
多阶段构建, 镜像层缓存, 大小缩减(通常 50-90%) |
k8s-manifest |
Kubernetes 部署 |
HPA, NetworkPolicy, PodSecurityPolicy, 支持服务网格 |
monitor-setup |
可观测性 |
Prometheus 指标, Grafana 仪表板, 告警规则 |
安全工具集成:Bandit, Safety, Trivy, Semgrep, Snyk, GitGuardian
数据和数据库操作
| 命令 |
数据库支持 |
迁移策略 |
db-migrate |
PostgreSQL, MySQL, MongoDB, DynamoDB |
蓝绿部署, 扩展-收缩, 版本化模式 |
data-pipeline |
批处理和流处理 |
Apache Spark, Kafka, Airflow, dbt 集成 |
data-validation |
模式和质量 |
Great Expectations, Pandera, 自定义验证器 |
零停机模式: 滚动迁移, 功能开关, 双写, 回填策略
性能和优化
| 命令 |
分析类型 |
优化技术 |
performance-optimization |
全栈性能分析 |
查询优化、缓存策略、CDN配置 |
cost-optimize |
云资源分析 |
合理配置大小、竞价实例、预留容量规划 |
docker-optimize |
容器性能 |
构建缓存优化, 最小基础镜像, 层级减少 |
附加资源
文档
源代码仓库
集成示例
# Complete feature development pipeline
/workflows:feature-development user authentication system
/tools:security-scan authentication implementation
/tools:test-harness authentication test suite
/tools:docker-optimize authentication service
/tools:k8s-manifest authentication deployment
/tools:monitor-setup authentication metrics
许可
MIT 许可证 - 请参阅 LICENSE 文件以获取完整条款。
支持与贡献