Slash命令系統
Slash命令是我用Claude Code時最常用的功能之一。透過簡單的 /命令 語法,可以快速執行常見任務、控制Claude行為,甚至建立自己的命令庫。
這篇文章詳細介紹Slash命令系統,以及如何用它們提升效率。
什麼是Slash命令
Slash命令就是以 / 開頭的特殊指令,用來在會話中控制Claude Code的行為。有點像終端命令,但更智慧、更靈活。
基本語法
/命令名称 [参数1] [参数2] ...
舉個例子:
/help # 查看帮助
/clear # 清除对话历史
/export conversation.md # 导出对话
/model opus-4 # 切换模型
Slash命令的優勢
- 快速執行:無需編寫完整的自然語言描述
- 標準化操作:確保任務執行的一致性
- 可定製化:建立符合你工作流程的自定義命令
- 團隊共享:透過專案配置共享團隊命令
- 上下文感知:命令可以訪問專案上下文和當前狀態
內建Slash命令完整列表
Claude Code提供了30多個內建命令,涵蓋會話管理、配置、開發工具等各個方面。
會話管理命令
| 命令 | 說明 | 示例 |
|---|---|---|
/clear | 清除對話歷史,開始新會話 | /clear |
/exit | 退出Claude Code | /exit |
/resume [session] | 恢復之前的對話會話 | /resume |
/export [filename] | 匯出對話到檔案或剪貼簿 | /export chat.md |
/rewind | 回退對話或程式碼到之前狀態 | /rewind |
/compact [instructions] | 壓縮對話歷史,可選聚焦指令 | /compact focus on auth |
專案和檔案命令
| 命令 | 說明 | 示例 |
|---|---|---|
/add-dir | 新增額外的工作目錄 | /add-dir ../shared-lib |
/init | 初始化專案,建立CLAUDE.md | /init |
/memory | 編輯CLAUDE.md記憶檔案 | /memory |
/review | 請求程式碼審查 | /review |
/security-review | 執行完整的安全審查 | /security-review |
/todos | 列出當前TODO項 | /todos |
系統和配置命令
| 命令 | 說明 | 示例 |
|---|---|---|
/help | 顯示所有可用命令 | /help |
/config | 開啟配置介面(Config標籤) | /config |
/status | 開啟設定介面(Status標籤) | /status |
/doctor | 檢查Claude Code安裝健康狀況 | /doctor |
/permissions | 檢視或更新許可權設定 | /permissions |
/output-style | 設定輸出樣式 | /output-style |
/vim | 進入vim模式 | /vim |
模型和使用情況命令
| 命令 | 說明 | 示例 |
|---|---|---|
/model | 選擇或更改AI模型 | /model opus-4 |
/context | 視覺化當前上下文使用情況 | /context |
/cost | 顯示token使用統計 | /cost |
/usage | 顯示計劃使用限制 | /usage |
/stats | 視覺化使用情況和會話歷史 | /stats |
整合和擴充套件命令
| 命令 | 說明 | 示例 |
|---|---|---|
/mcp | 管理MCP伺服器連線 | /mcp |
/plugin | 管理外掛 | /plugin |
/agents | 管理自定義AI子代理 | /agents |
/hooks | 管理鉤子配置 | /hooks |
/ide | 管理IDE整合 | /ide |
/sandbox | 啟用沙箱bash工具 | /sandbox |
賬號管理命令
| 命令 | 說明 | 示例 |
|---|---|---|
/login | 切換Anthropic賬號 | /login |
/logout | 登出當前賬號 | /logout |
其他實用命令
| 命令 | 說明 | 示例 |
|---|---|---|
/bug | 向Anthropic報告bug | /bug |
/bashes | 列出和管理後臺任務 | /bashes |
常用命令詳細講解
/help - 檢視幫助
最基礎也是最重要的命令。它會顯示所有可用的Slash命令,包括:
- 內建命令
- 專案自定義命令(來自
.claude/commands/) - 個人自定義命令(來自
~/.claude/commands/) - MCP伺服器提供的命令
使用場景:
# 查看所有命令
/help
# 输出示例:
# Available slash commands:
#
# Built-in commands:
# /clear - Clear conversation history
# /export - Export conversation to file
# ...
#
# Project commands:
# /commit - Create a git commit (project)
# /test - Run tests (project)
# ...
#
# Personal commands:
# /review - Code review (user)
# ...
/clear - 清除對話歷史
清除當前對話的所有歷史記錄,但不會退出會話。適合:
- 開始全新的任務
- 釋放上下文空間
- 避免之前對話的干擾
與/exit的區別:
/clear:清空對話,保持會話活躍/exit:完全退出Claude Code
使用示例:
# 场景1:切换到新任务
你: 帮我创建一个登录表单
Claude: [完成登录表单]
你: /clear
你: 现在帮我设计一个数据库schema
Claude: [开始新任务,不受之前对话影响]
# 场景2:上下文太多时
你: /context
# 显示:Context usage: 85% (170K/200K tokens)
你: /clear
你: /context
# 显示:Context usage: 5% (10K/200K tokens)
/export - 匯出對話
將對話歷史匯出為Markdown檔案,便於:
- 文件記錄
- 知識分享
- 復現問題
- 學習參考
使用方式:
# 导出到文件
/export conversation.md
# 导出到剪贴板(不指定文件名)
/export
# 导出后查看
cat conversation.md
匯出格式示例:
# Claude Code Conversation
Date: 2025-12-25
## User
创建一个React组件
## Claude
I'll create a React component for you...
[代码内容]
## User
添加状态管理
## Claude
I'll add state management...
/context - 檢視上下文使用
實時監控上下文視窗的使用情況,幫助你:
- 瞭解還能容納多少程式碼
- 決定是否需要壓縮對話
- 最佳化大型專案的工作方式
使用示例:
/context
# 输出:
# Context Usage Visualization
# ================================
# Total: 200,000 tokens
# Used: 45,234 tokens (22.6%)
#
# Distribution:
# - System prompt: 1,200 tokens (0.6%)
# - CLAUDE.md: 3,500 tokens (1.8%)
# - Files: 28,534 tokens (14.3%)
# - Conversation: 12,000 tokens (6.0%)
#
# [████████░░░░░░░░░░] 22.6%
何時使用:
- 處理大型檔案時
- 對話輪次較多時
- 感覺響應變慢時
- 使用
/compact之前
/compact - 壓縮對話
智慧壓縮對話歷史,保留重要資訊,釋放上下文空間。
基本用法:
# 自动压缩
/compact
# 带聚焦指令的压缩
/compact focus on authentication changes
/compact keep database schema discussions
工作原理:
- 分析對話歷史
- 識別關鍵決策和程式碼更改
- 刪除冗餘內容
- 生成簡潔的摘要
使用場景:
# 场景:长时间开发后上下文快满了
你: /context
# Context usage: 88% (176K/200K tokens)
你: /compact focus on API changes and database schema
# Claude会压缩对话,保留API和数据库相关的讨论
你: /context
# Context usage: 35% (70K/200K tokens)
/model - 切換模型
在不同的Claude模型之間切換,適應不同場景:
- Sonnet:平衡效能和速度,日常開發
- Opus:最強能力,複雜任務
- Haiku:最快速度,簡單任務
使用方式:
# 查看可用模型
/model
# 切换到Opus 4.5(最强)
/model opus-4
# 切换到Sonnet(平衡)
/model sonnet
# 切换到Haiku(快速)
/model haiku
使用建議:
# 复杂架构设计 → Opus
/model opus-4
你: 设计一个微服务架构,包含用户服务、订单服务、支付服务
# 日常开发 → Sonnet
/model sonnet
你: 添加一个新的API端点
# 简单修复 → Haiku
/model haiku
你: 修复这个拼写错误
/cost - 檢視使用成本
顯示當前會話和歷史的token使用情況:
/cost
# 输出示例:
# Token Usage Statistics
# =====================
# Current Session:
# Input tokens: 12,450
# Output tokens: 8,320
# Total cost: $0.62
#
# Today:
# Sessions: 5
# Total tokens: 125,600
# Total cost: $3.15
#
# This Month:
# Sessions: 87
# Total tokens: 2,458,900
# Total cost: $58.34
/usage - 檢視配額使用
檢查你的訂閱計劃使用情況:
/usage
# 输出示例:
# Plan Usage (Pro Plan)
# =====================
# Messages sent: 1,245 / 10,000
# Rate limit: 25 messages per 5 minutes
#
# Current period: Dec 1 - Dec 31
# Resets in: 6 days
#
# Extended thinking usage:
# Normal thinking: 823 messages
# Deep thinking: 422 messages
/review - 程式碼審查
請求Claude進行程式碼審查:
/review
# Claude会:
# 1. 检查最近的代码更改
# 2. 分析代码质量
# 3. 提供改进建议
# 4. 标注潜在问题
輸出示例:
Code Review Report
==================
Files Reviewed: 3
- src/auth.js
- src/api/users.js
- tests/auth.test.js
Findings:
🔴 Critical Issues (1):
- auth.js:45 - Password stored in plain text
Recommendation: Use bcrypt for password hashing
🟡 Warnings (3):
- users.js:23 - Missing error handling in async function
- users.js:67 - SQL injection vulnerability
- auth.test.js:12 - Test missing edge case
🟢 Suggestions (5):
- Consider extracting validation logic
- Add JSDoc comments to public methods
- Use const instead of let where possible
/init - 初始化專案
為專案建立CLAUDE.md配置檔案:
/init
# Claude会询问:
# - 项目类型(Web App, CLI Tool, Library等)
# - 技术栈(React, Python, etc.)
# - 编码规范(Airbnb, Standard, etc.)
# - 项目约定
生成的CLAUDE.md示例:
# Project: My Web App
## Tech Stack
- Frontend: React 18 + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL
- Testing: Jest
## Coding Standards
- Use TypeScript strict mode
- Follow Airbnb style guide
- Write unit tests for all business logic
- Use functional components with hooks
## Project Structure
/src
/components - React components
/api - API routes
/utils - Utility functions
/types - TypeScript types
/todos - 任務管理
列出當前的TODO項:
/todos
# 输出:
# Current TODO Items
# ==================
#
# In Progress (1):
# ⏳ Implementing user authentication
#
# Pending (3):
# ☐ Add input validation
# ☐ Write unit tests
# ☐ Update documentation
#
# Completed (2):
# ✓ Set up database connection
# ✓ Create user model
/mcp - MCP伺服器管理
管理Model Context Protocol伺服器連線:
/mcp
# 选项:
# 1. List connected servers
# 2. Add new server
# 3. Remove server
# 4. Test connection
# 5. View server capabilities
建立自定義Slash命令
自定義命令是Slash系統最強大的功能。你可以建立符合自己工作流程的命令。
專案命令 vs 個人命令
專案命令(團隊共享):
- 位置:
.claude/commands/ - 特點:隨專案版本控制,團隊成員共享
- 標識:在
/help中顯示(project) - 用途:專案特定的工作流程
個人命令(個人使用):
- 位置:
~/.claude/commands/ - 特點:跨專案使用,個人偏好
- 標識:在
/help中顯示(user) - 用途:個人習慣和常用操作
建立第一個自定義命令
示例1:簡單的程式碼最佳化命令
# 创建命令目录
mkdir -p .claude/commands
# 创建命令文件
cat > .claude/commands/optimize.md << 'EOF'
分析这段代码的性能问题并提供优化建议:
请关注:
1. 时间复杂度
2. 空间复杂度
3. 不必要的循环或计算
4. 可以缓存的结果
5. 可以并行化的操作
提供具体的优化代码实现。
EOF
使用:
你: /optimize
# 然后粘贴或选择要优化的代码
示例2:帶引數的命令
建立一個修復issue的命令:
cat > .claude/commands/fix-issue.md << 'EOF'
修复issue #$ARGUMENTS
请按以下步骤进行:
1. 理解issue的描述和复现步骤
2. 定位相关代码
3. 分析根本原因
4. 实现修复
5. 添加测试用例防止回归
6. 更新相关文档
EOF
使用:
/fix-issue 123
# $ARGUMENTS 会被替换为 "123"
示例3:多個引數的命令
建立PR審查命令:
cat > .claude/commands/review-pr.md << 'EOF'
---
argument-hint: [pr-number] [priority] [assignee]
description: Review pull request with priority
---
审查PR #$1,优先级:$2,分配给:$3
审查重点:
1. 代码质量和风格
2. 安全性问题
3. 性能影响
4. 测试覆盖率
5. 文档完整性
请提供详细的审查报告和改进建议。
EOF
使用:
/review-pr 456 high alice
# $1=456, $2=high, $3=alice
高階命令:整合Bash和Git
示例4:智慧Git提交
cat > .claude/commands/commit.md << 'EOF'
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a smart git commit
---
## 当前状态
- Git状态: !`git status`
- 暂存变更: !`git diff --cached`
- 未暂存变更: !`git diff`
- 当前分支: !`git branch --show-current`
- 最近提交: !`git log --oneline -5`
## 任务
基于上述变更,创建一个符合规范的git commit:
1. 分析变更内容和影响范围
2. 编写清晰的commit message(使用约定式提交格式)
3. 如果有未暂存的相关变更,先添加到暂存区
4. 执行提交
Commit message格式:
type(scope): subject
body
footer
类型:feat, fix, docs, style, refactor, test, chore
EOF
使用效果:
你: /commit
Claude分析:
- 检测到3个文件变更
- 主要是认证功能的改进
- 修复了一个安全漏洞
Claude执行:
git add src/auth.js src/middleware/verify.js tests/auth.test.js
git commit -m "fix(auth): prevent timing attack in token verification
- Use constant-time comparison for token validation
- Add rate limiting to authentication endpoints
- Update tests to cover security scenarios
Closes #234"
示例5:完整的測試工作流
cat > .claude/commands/test-feature.md << 'EOF'
---
allowed-tools: Bash(npm test:*), Bash(npm run:*), Bash(git:*)
argument-hint: [feature-name]
description: Complete testing workflow for a feature
---
## 测试工作流:$ARGUMENTS
### 第一步:分析功能
1. 找到 $ARGUMENTS 相关的代码文件
2. 理解功能的输入、输出和边界情况
3. 识别需要测试的场景
### 第二步:编写测试
创建测试用例覆盖:
- ✓ 正常流程(happy path)
- ✓ 边界条件
- ✓ 错误处理
- ✓ 边缘情况
### 第三步:运行测试
执行命令:!`npm test -- --coverage`
### 第四步:分析结果
检查:
- 所有测试是否通过
- 代码覆盖率是否达标(>80%)
- 是否有遗漏的场景
### 第五步:生成报告
总结测试结果和改进建议。
EOF
使用Frontmatter配置
Frontmatter允許你精細控制命令的行為:
---
# 允许的工具(安全限制)
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
# 参数提示(帮助文档)
argument-hint: [pr-number] [reviewer]
# 命令描述
description: Submit PR for code review
# 指定使用的模型
model: claude-3-5-haiku-20241022
# 禁止Claude自动调用此命令
disable-model-invocation: false
---
你的命令内容...
Frontmatter欄位說明:
| 欄位 | 說明 | 示例 |
|---|---|---|
allowed-tools | 限制命令可使用的工具 | Bash(git:*) |
argument-hint | 顯示引數提示 | [file] [line] |
description | 命令簡短描述 | Fix linting errors |
model | 指定AI模型 | claude-3-opus-4 |
disable-model-invocation | 禁止自動呼叫 | true |
命令中的特殊語法
1. 引數引用
# 所有参数
$ARGUMENTS
# 单个参数
$1, $2, $3, ...
# 示例
/command arg1 arg2 arg3
# $ARGUMENTS = "arg1 arg2 arg3"
# $1 = "arg1"
# $2 = "arg2"
# $3 = "arg3"
2. Bash命令執行
使用 ! 字首執行bash命令並插入結果:
当前分支:!`git branch --show-current`
当前时间:!`date`
文件数量:!`find . -name "*.js" | wc -l`
3. 檔案引用
使用 @ 引用檔案:
分析 @src/utils/helpers.js 中的问题
对比这两个文件:
- @src/old-version.js
- @src/new-version.js
命令組合使用示例
場景1:完整的功能開發流程
# 1. 清空上下文,开始新功能
/clear
# 2. 创建功能分支并开发
你: 创建一个用户认证功能
# 3. 查看上下文使用情况
/context
# 4. 如果上下文较多,压缩一下
/compact focus on authentication implementation
# 5. 运行测试
/test-feature authentication
# 6. 代码审查
/review
# 7. 创建智能提交
/commit
# 8. 导出开发记录
/export auth-feature-development.md
場景2:bug修復工作流
# 1. 修复issue
/fix-issue 789
# 2. 运行相关测试
你: 运行与此bug相关的测试
# 3. 安全审查
/security-review
# 4. 提交修复
/commit
# 5. 查看成本
/cost
場景3:程式碼重構
# 1. 审查当前代码
/review
# 2. 优化性能
/optimize
# 3. 运行完整测试套件
你: 运行所有测试确保没有破坏功能
# 4. 查看变更
你: 显示所有修改的文件
# 5. 分步提交
/commit
建立自己的命令庫
通用命令庫結構
建議的目錄結構:
.claude/commands/
├── workflow/ # 工作流命令
│ ├── feature.md # 新功能开发
│ ├── bugfix.md # bug修复
│ └── refactor.md # 代码重构
├── git/ # Git相关
│ ├── commit.md # 智能提交
│ ├── pr.md # PR创建
│ └── release.md # 发布管理
├── test/ # 测试相关
│ ├── unit.md # 单元测试
│ ├── e2e.md # 端到端测试
│ └── coverage.md # 覆盖率检查
├── review/ # 代码审查
│ ├── security.md # 安全审查
│ ├── performance.md # 性能审查
│ └── style.md # 代码风格
└── docs/ # 文档相关
├── api.md # API文档
├── readme.md # README生成
└── changelog.md # 变更日志
實用命令模板庫
1. 新功能開發模板
---
# .claude/commands/workflow/feature.md
argument-hint: [feature-name]
description: Complete workflow for new feature development
---
## 功能开发:$ARGUMENTS
### 阶段1:规划设计
1. 理解需求和用户场景
2. 设计技术方案
3. 评估技术风险
4. 制定开发计划
### 阶段2:实现开发
1. 创建功能分支:!`git checkout -b feature/$ARGUMENTS`
2. 编写核心代码
3. 添加错误处理
4. 实现日志记录
### 阶段3:测试验证
1. 编写单元测试
2. 执行集成测试
3. 检查代码覆盖率
4. 进行手动测试
### 阶段4:代码审查
1. 自我审查代码质量
2. 检查安全性问题
3. 验证性能影响
4. 更新相关文档
### 阶段5:提交发布
1. 创建commit:!`git add .`
2. 生成变更日志
3. 创建Pull Request
4. 通知团队审查
2. 效能最佳化模板
---
# .claude/commands/review/performance.md
description: Comprehensive performance analysis and optimization
---
## 性能优化分析
### 当前性能指标
执行性能分析:!`npm run benchmark`
### 分析重点
1. **算法复杂度**
- 识别O(n²)及以上的算法
- 寻找优化机会
2. **内存使用**
- 检查内存泄漏
- 优化大对象处理
3. **数据库查询**
- N+1查询问题
- 索引优化机会
4. **网络请求**
- 批量请求机会
- 缓存策略
5. **渲染性能**(前端)
- 不必要的重渲染
- 组件优化
### 优化建议
提供3-5个具体的优化方案,包括:
- 问题描述
- 预期收益
- 实现难度
- 代码示例
3. 安全審查模板
---
# .claude/commands/review/security.md
description: Security vulnerability scan and remediation
---
## 安全审查清单
### 1. 输入验证
- [ ] 所有用户输入都经过验证
- [ ] 使用白名单而非黑名单
- [ ] 适当的长度和格式限制
### 2. 认证和授权
- [ ] 密码安全存储(bcrypt/argon2)
- [ ] Session管理安全
- [ ] JWT token正确实现
- [ ] 权限检查完整
### 3. 数据保护
- [ ] 敏感数据加密
- [ ] HTTPS强制使用
- [ ] SQL注入防护
- [ ] XSS防护
### 4. 依赖安全
执行安全扫描:!`npm audit`
### 5. 错误处理
- [ ] 不泄露敏感信息
- [ ] 适当的错误日志
- [ ] 用户友好的错误消息
### 扫描结果
分析代码并生成:
1. 🔴 高危问题列表
2. 🟡 中危问题列表
3. 🟢 最佳实践建议
4. 修复优先级排序
4. API文件生成模板
---
# .claude/commands/docs/api.md
argument-hint: [endpoint-path]
description: Generate comprehensive API documentation
---
## API文档:$ARGUMENTS
### 端点信息
**URL**: `$ARGUMENTS`
**方法**: [自动检测]
**认证**: [是/否]
### 请求参数
#### Headers
```json
{
"Content-Type": "application/json",
"Authorization": "Bearer <token>"
}
Path Parameters
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| [自动提取] |
Query Parameters
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|---|---|---|---|---|
| [自动提取] |
Body Parameters
[自動生成示例]
响应格式
成功响应 (200)
[自動生成示例]
错误响应
| 状态码 | 说明 | 响应示例 |
|---|---|---|
| 400 | Bad Request | |
| 401 | Unauthorized | |
| 404 | Not Found | |
| 500 | Server Error |
使用示例
cURL
[自動生成]
JavaScript
[自動生成]
Python
[自動生成]
注意事项
[提取相关的注意事项和最佳实践]
## 團隊共享命令的方法
### 方法1:Git版本控制(推薦)
**優點**:
- 自動同步
- 版本歷史
- 程式碼審查
- 易於回滾
**實施步驟**:
1. **建立命令目錄**:
```bash
mkdir -p .claude/commands
- 新增到Git:
git add .claude/commands/
git commit -m "feat: add team slash commands"
git push
- 團隊成員拉取:
git pull
# 命令自动可用
- 更新命令:
# 编辑命令
vim .claude/commands/review.md
# 提交更新
git add .claude/commands/review.md
git commit -m "feat: improve review command"
git push
方法2:共享文件
- 建立團隊命令文件:
# team-commands.md
## 安装命令
bash
# 克隆团队命令库
git clone https://github.com/your-team/claude-commands.git ~/.claude/team-commands
# 链接到项目
ln -s ~/.claude/team-commands/* .claude/commands/
- 維護命令庫倉庫:
claude-commands/
├── README.md
├── workflow/
├── git/
├── test/
└── review/
方法3:配置檔案共享
在CLAUDE.md中記錄團隊命令:
# CLAUDE.md
## 团队Slash命令
### /feature [name]
开发新功能的完整工作流
位置:`.claude/commands/workflow/feature.md`
### /commit
智能Git提交
位置:`.claude/commands/git/commit.md`
### /review
代码审查
位置:`.claude/commands/review/security.md`
## 安装说明
bash
cp docs/commands/* .claude/commands/
最佳實踐
-
命名規範:
- 使用清晰、描述性的名稱
- 避免過長的命令名
- 保持一致的命名風格
-
文件完善:
- 每個命令都有描述
- 提供使用示例
- 說明引數含義
-
版本管理:
- 重大更新要通知團隊
- 保持向後相容
- 記錄變更日誌
-
許可權控制:
- 限制危險操作的工具許可權
- 使用
allowed-tools欄位
-
持續最佳化:
- 收集團隊反饋
- 定期審查和更新
- 刪除不再使用的命令
高階技巧
技巧1:命令鏈式呼叫
在CLAUDE.md中配置自動呼叫:
# CLAUDE.md
当我说"完成功能开发"时,请依次执行:
1. /review - 代码审查
2. /test-feature - 运行测试
3. /commit - 创建提交
4. /export - 导出开发日志
技巧2:條件命令
---
# .claude/commands/smart-commit.md
description: Smart commit based on changes
---
## 分析变更
当前状态:!`git status --short`
## 决策
如果变更包含:
- `.test.js` 文件 → 提交类型:test
- `.md` 文件 → 提交类型:docs
- `package.json` → 提交类型:chore
- 其他 → 提交类型:feat/fix(根据内容判断)
创建相应的提交。
技巧3:互動式命令
---
# .claude/commands/interactive-feature.md
description: Interactive feature development
---
## 功能开发向导
我会问你几个问题来更好地开发这个功能:
1. **功能名称**是什么?
2. **主要用途**是什么?
3. **目标用户**是谁?
4. 有哪些**技术限制**或**依赖**?
5. **优先级**如何(高/中/低)?
请逐一回答,我会根据你的回答制定开发计划。
技巧4:動態引數生成
---
# .claude/commands/fix-latest-issue.md
description: Fix the most recent open issue
---
## 获取最新Issue
最新的开放Issue:!`gh issue list --limit 1 --json number,title`
## 修复流程
基于上述Issue,执行修复流程...
技巧5:模板變數
建立可重用的模板:
---
# .claude/commands/api-endpoint.md
argument-hint: [resource-name]
description: Generate complete REST API endpoint
---
## 创建 $ARGUMENTS API端点
### 生成文件:
1. **Controller**: `src/controllers/$ARGUMENTSController.js`
- GET /api/$ARGUMENTS
- GET /api/$ARGUMENTS/:id
- POST /api/$ARGUMENTS
- PUT /api/$ARGUMENTS/:id
- DELETE /api/$ARGUMENTS/:id
2. **Model**: `src/models/$ARGUMENTS.js`
- Schema定义
- Validation规则
3. **Routes**: `src/routes/$ARGUMENTS.js`
- 路由配置
- 中间件绑定
4. **Tests**: `tests/$ARGUMENTS.test.js`
- CRUD操作测试
- 验证测试
完成后运行测试:!`npm test tests/$ARGUMENTS.test.js`
常見問題
Q1: 命令不生效怎麼辦?
檢查步驟:
# 1. 验证命令文件存在
ls .claude/commands/your-command.md
# 2. 检查文件格式
cat .claude/commands/your-command.md
# 3. 重新加载命令
/help
# 4. 检查权限
ls -la .claude/commands/
Q2: 如何除錯命令?
# 在命令中添加调试信息
---
description: Debug command
---
## 调试信息
参数1: $1
参数2: $2
所有参数: $ARGUMENTS
工作目录: !`pwd`
Git状态: !`git status`
[命令内容...]
Q3: 命令可以訪問環境變數嗎?
可以,透過bash命令:
当前用户: !`echo $USER`
Node版本: !`node --version`
自定义变量: !`echo $MY_VAR`
Q4: 如何限制命令許可權?
使用allowed-tools:
---
allowed-tools: Bash(git status:*), Bash(git diff:*)
---
只能查看Git状态,不能执行提交或推送。
Q5: 命令可以巢狀呼叫嗎?
不能直接巢狀,但可以在CLAUDE.md中配置工作流:
# CLAUDE.md
执行完整审查流程:
1. 先运行 /review
2. 然后运行 /security-review
3. 最后运行 /performance
總結
Slash命令系統是Claude Code最強大的效率工具:
核心優勢:
- ✅ 30+內建命令覆蓋常見需求
- ✅ 完全可定製的命令系統
- ✅ 支援團隊協作和共享
- ✅ 靈活的引數和bash整合
- ✅ 安全的許可權控制
使用建議:
- 從內建命令開始,熟悉基本用法
- 識別重複性任務,建立自定義命令
- 用Git共享團隊命令
- 持續最佳化和改進命令庫
- 利用frontmatter實現高階功能
學習路徑:
- 掌握常用內建命令(/help, /clear, /context等)
- 建立第一個簡單命令
- 學習引數和bash整合
- 構建完整的工作流命令
- 分享給團隊使用
透過合理使用Slash命令,可以把重複性工作自動化,提升開發效率,建立標準化的工作流程。開始建立你的命令庫吧!