自定义 Slash Commands 使用指南 | 120+ 命令全面覆盖开发工作流
本文档汇总了所有自定义 Slash Commands 的详细使用说明,帮助你快速掌握这些强大的开发辅助工具。
- Commands 概览
- 核心思维命令
- Kiro 特性开发框架
- SC (Serena) AI辅助开发系统
- Cook 通用开发工具集
- GitHub 集成命令
- BMad 业务敏捷方法论
- Claude Code 元工具
- 代码清理工具
- 使用技巧
- 最佳实践
| 类别 | 命令数 | 核心用途 | 推荐度 |
|---|---|---|---|
| 🧠 核心思维 | 6 | 深度分析、反思、学习捕获 | ⭐⭐⭐⭐⭐ |
| 🎯 Kiro | 5 | 特性驱动开发工作流 | ⭐⭐⭐⭐⭐ |
| 🤖 SC/Serena | 25+ | AI辅助开发全流程 | ⭐⭐⭐⭐⭐ |
| 🍳 Cook | 40+ | 通用开发和协作工具 | ⭐⭐⭐⭐ |
| 🐙 GitHub | 3 | GitHub PR/Issue 集成 | ⭐⭐⭐⭐⭐ |
| 📊 BMad | 30+ | 敏捷开发方法论和角色 | ⭐⭐⭐⭐ |
| ⚙️ CC | 1 | Claude Code 自定义 | ⭐⭐⭐ |
| 🧹 清理 | 2 | 代码质量和规范 | ⭐⭐⭐⭐⭐ |
总命令数: 120+ 个
适用于最复杂问题的超全面分析性思维框架,提供 7 个层次的深度分析。
分析阶段:
- 本体论分析 - 问题的本质和构成
- 认识论检查 - 如何知道和验证
- 多范式分析 - 从不同视角审视
- 跨学科整合 - 综合多领域知识
- 时空尺度分析 - 历史和未来影响
- 不确定性建模 - 风险和变量分析
- 元认知反思 - 思维过程本身的反思
# 基本用法
/think-ultra [complex problem or question]
# 示例
/think-ultra 如何设计一个可扩展的微服务架构来支持百万级并发- 🏗️ 系统架构设计决策
- 🔬 技术选型和评估
- 📊 复杂商业问题分析
- 🎓 学术研究和理论探讨
适用于复杂问题的增强分析,提供 4 个阶段的系统化思考。
分析阶段:
- 问题澄清 - 重构和明确问题
- 多维度分析 - 从多个角度深入分析
- 批判性评估 - 识别假设和限制
- 综合整合 - 整合洞察,形成结论
# 基本用法
/think-harder [problem or question]
# 示例
/think-harder 为什么我的 API 响应时间从 100ms 增加到 500ms- 🐛 复杂 bug 调查
- 🚀 性能优化分析
- 🔄 重构方案评估
- 📈 技术债务分析
捕获技术突破并转化为可操作、可重用的文档。
文档结构:
- 📝 一行摘要
- 🎯 问题描述
- 💡 关键洞察
- 💻 实现代码
- 📊 影响指标
- 🔄 可重用模式
# 基本用法
/eureka [breakthrough description]
# 示例
/eureka 发现使用 Redis pipeline 可以将批量写入性能提升 10 倍breakthroughs/YYYY-MM-DD-[name].md
- 🎉 重大性能优化
- 🔧 创新解决方案
- 📚 可复用模式发现
- 💎 最佳实践提炼
分析和改进 Claude Code 指令 (CLAUDE.md),通过对话历史识别改进机会。
工作流程:
- 📖 分析聊天历史和 CLAUDE.md
- 🔍 识别改进机会
- 💬 交互式提出建议
- ✅ 实施批准的更改
# 基本用法
/reflection- 📝 优化项目指令
- 🔧 改进工作流配置
- 📊 提升 AI 协作效率
深度会话回顾和学习捕获,提取问题解决模式和用户偏好。
输出章节:
- 📋 会话概览
- ✅ 解决的问题
- 🔄 建立的模式
- 👤 用户偏好
- 🔗 系统关系
- 📚 知识更新
- 🚀 未来改进
# 基本用法
/reflection-harder- 📊 项目复盘
- 🧠 知识沉淀
- 🔍 工作流优化
将项目规则转换为 Claude Code hooks 配置。
Hook 事件类型:
PreToolUse- 工具执行前运行,可阻止执行PostToolUse- 工具成功完成后运行Stop- Claude 完成响应时运行Notification- 发送通知时运行
# 基本用法
/rule2hook- ⚙️ 自动化工作流配置
- 🔒 添加安全检查
- 📝 强制代码规范
Kiro 是一个完整的特性驱动开发框架,提供从需求到实现的全流程支持。
需求 → 设计 → 任务 → 执行
↓ ↓ ↓ ↓
spec design task execute
从需求到实施计划创建完整的功能规范,使用 EARS 格式。
三步流程:
- 需求收集 - 生成 EARS 格式需求
- 创建设计 - 基于需求开发设计
- 创建任务 - 生成实施计划
核心约束:
- ✅ 必须创建
.kiro/specs/{feature_name}/requirements.md - ✅ 必须创建
.kiro/specs/{feature_name}/design.md - ✅ 必须创建
.kiro/specs/{feature_name}/tasks.md ⚠️ 每个阶段需用户批准
# 基本用法
/kiro:spec [feature name or rough idea]
# 示例
/kiro:spec 用户认证系统
/kiro:spec 实时通知功能- 🚀 新功能完整规划
- 📋 需求规范化
- 🏗️ 架构设计决策
创建全面的功能设计文档,包含研究和架构。
必须包含章节:
- 📝 概览
- 🏗️ 架构
- 🔧 组件和接口
- 💾 数据模型
⚠️ 错误处理- 🧪 测试策略
# 基本用法
/kiro:design [feature name or rough idea]
# 示例
/kiro:design 分布式缓存系统- 🎨 技术方案设计
- 🔍 技术调研
- 📐 接口设计
从批准的设计生成实施任务列表,转换为可执行的提示序列。
任务特点:
- 📋 最多两层编号复选框
- 🔗 每个任务引用具体需求
- 🤖 专注于可由 AI 执行的任务
# 基本用法
/kiro:task [feature name]
# 示例
/kiro:task user-authentication.kiro/specs/[feature-name]/tasks.md
从 Kiro 规范执行特定任务,聚焦单一任务完成。
核心原则:
- 📖 执行前读取 requirements.md, design.md, tasks.md
- 🎯 一次只专注一个任务
- ✋ 完成后停止,等待审查
- ❌ 不自动继续下一任务
# 使用任务编号
/kiro:execute user-auth 1.2
# 使用任务描述
/kiro:execute user-auth "implement JWT token generation"
# 示例
/kiro:execute payment-system 2.1使用 Kiro 轻松、以开发者为中心的方法提供快速开发帮助。
核心风格:
- 💬 像人类说话,不像机器人
- 🧠 知识渊博但不说教
- 🤝 支持性而非权威性
- 😊 轻松但不懒散
- ⚡ 简洁直接
# 基本用法
/kiro:vibe [problem or question]
# 示例
/kiro:vibe 为什么我的 Docker 容器总是重启
/kiro:vibe 快速搭建一个 React + Vite 项目- ❓ 快速问题解答
- 💡 即时技术咨询
- 🚀 快速原型开发
SC (Serena Commands) 是一个全面的 AI 辅助开发系统,提供 25+ 个命令覆盖完整开发生命周期。
| 分类 | 命令 | 数量 |
|---|---|---|
| 🔨 核心开发 | implement, design, test, build | 4 |
| 💾 会话管理 | save, load, index | 3 |
| 🔍 代码质量 | analyze, improve, cleanup | 3 |
| 📝 文档 | document, explain | 2 |
| 🤔 分析 | brainstorm, workflow, estimate | 3 |
| 🐛 问题解决 | troubleshoot, reflect | 2 |
| 🔧 辅助工具 | help, select-tool, spec-panel, git, task | 5+ |
功能: 功能和代码实现,包含智能 persona 激活和 MCP 集成
# 示例
/sc:implement 实现用户登录功能功能: 设计系统架构、API 和组件接口,提供全面规范
# 示例
/sc:design 设计微服务间的通信机制功能: 执行测试,包含覆盖率分析和自动化质量报告
# 示例
/sc:test功能: 构建、编译和打包项目,包含智能错误处理和优化
# 示例
/sc:build功能: 会话上下文持久化,使用 Serena MCP 集成
# 示例
/sc:save功能: 加载项目上下文,使用 Serena MCP 集成
# 示例
/sc:load [project-name]功能: 生成全面的项目文档和知识库,包含智能组织
# 示例
/sc:index功能: 跨质量、安全性、性能和架构领域的全面代码分析
# 示例
/sc:analyze分析维度:
- 📊 代码质量
- 🔒 安全性
- ⚡ 性能
- 🏗️ 架构
功能: 系统化改进代码质量、性能和可维护性
# 示例
/sc:improve src/api/user.ts功能: 系统化清理代码,移除死代码,优化项目结构
# 示例
/sc:cleanup功能: 为组件、函数、API 和功能生成聚焦文档
# 示例
/sc:document getUserProfile 函数功能: 提供清晰的代码、概念和系统行为解释
# 示例
/sc:explain 这个递归算法是如何工作的功能: 通过苏格拉底式对话和系统探索进行交互式需求发现
# 示例
/sc:brainstorm 新功能需求讨论功能: 从 PRD 和功能需求生成结构化实施工作流
# 示例
/sc:workflow 生成支付模块实施流程功能: 使用智能分析为任务、功能或项目提供开发估算
# 示例
/sc:estimate 实现搜索功能需要多长时间功能: 诊断和解决代码、构建、部署和系统行为中的问题
# 示例
/sc:troubleshoot 应用启动失败功能: 使用 Serena MCP 分析能力进行任务反思和验证
# 示例
/sc:reflect功能: 列出所有可用的 /sc 命令及其功能
# 示例
/sc:help功能: 基于复杂度评分和操作分析的智能 MCP 工具选择
# 示例
/sc:select-tool 数据库迁移功能: 使用著名规范和软件工程专家进行多专家规范审查和改进
# 示例
/sc:spec-panel 审查 API 设计文档功能: Git 操作,包含智能提交消息和工作流优化
# 示例
/sc:git commit 实现用户认证功能: 使用智能工作流管理和委托执行复杂任务
# 示例
/sc:task 重构数据访问层功能: 使用智能分解和委托的元系统任务编排
# 示例
/sc:spawn 实现完整的 CRUD 功能Cook 命令集提供 40+ 个实用工具,覆盖 PR 管理、代码质量、依赖更新、规划思维和团队协作等多个领域。
| 命令 | 功能 |
|---|---|
/cook/pr-create |
创建 Pull Request |
/cook/pr-review |
审查 Pull Request |
/cook/pr-list |
列出所有 PR |
/cook/pr-feedback |
PR 反馈 |
/cook/pr-auto-update |
PR 自动更新 |
/cook/pr-issue |
PR 问题处理 |
/cook/commit-message |
生成提交消息 |
/cook/semantic-commit |
语义化提交 |
/cook/check-github-ci |
检查 GitHub CI |
/cook/gh-commit |
GitHub 提交 |
# 创建 PR
/cook/pr-create
# 审查 PR
/cook/pr-review 123
# 语义化提交
/cook/semantic-commit feat: add user login| 命令 | 功能 |
|---|---|
/cook/refactor |
重构代码 |
/cook/explain-code |
解释代码 |
/cook/fix-error |
修复错误 |
/cook/analyze-dependencies |
分析依赖 |
/cook/analyze-performance |
性能分析 |
/cook/design-patterns |
设计模式 |
/cook/tech-debt |
技术债务 |
/cook/smart-review |
智能审查 |
# 重构代码
/cook/refactor src/utils/legacy.js
# 性能分析
/cook/analyze-performance
# 技术债务评估
/cook/tech-debt| 命令 | 功能 |
|---|---|
/cook/update-node-deps |
更新 Node 依赖 |
/cook/update-flutter-deps |
更新 Flutter 依赖 |
/cook/update-rust-deps |
更新 Rust 依赖 |
/cook/update-dart-doc |
更新 Dart 文档 |
/cook/update-doc-string |
更新文档字符串 |
# 更新 Node 依赖
/cook/update-node-deps
# 更新文档
/cook/update-doc-string| 命令 | 功能 |
|---|---|
/cook/plan |
制定计划 |
/cook/show-plan |
显示计划 |
/cook/task |
任务管理 |
/cook/spec |
编写规范 |
/cook/ultrathink |
超级思考 |
/cook/sequential-thinking |
序列思考 |
# 制定开发计划
/cook/plan 实现搜索功能
# 显示当前计划
/cook/show-plan
# 深度思考
/cook/ultrathink 如何优化数据库查询| 命令 | 功能 |
|---|---|
/cook/multi-role |
多角色协作 |
/cook/role |
角色扮演 |
/cook/role-help |
角色帮助 |
/cook/role-debate |
角色辩论 |
/cook/team-collab |
团队协作 |
# 多角色讨论
/cook/multi-role architect,developer,tester
# 角色辩论
/cook/role-debate 单体 vs 微服务架构| 命令 | 功能 |
|---|---|
/cook/screenshot |
截图工具 |
/cook/context7 |
Context7 集成 |
/cook/search-gemini |
Gemini 搜索 |
/cook/check-fact |
事实检查 |
/cook/check-prompt |
检查提示 |
/cook/style-ai-writing |
AI 写作风格 |
使用详细代码分析审查 GitHub Pull Request。
# 基本用法
/gh:review-pr [pr-number]
# 示例
/gh:review-pr 123- 📝 代码质量
- 🔒 安全性问题
- ⚡ 性能影响
- 🧪 测试覆盖率
- 📐 架构合理性
自动分析并修复 GitHub Issue。
# 基本用法
/gh:fix-issue [issue-number]
# 示例
/gh:fix-issue 456GitHub 提交辅助工具。
# 基本用法
/gh:gh-commitBMad 提供完整的敏捷开发方法论,包含 10 个专家角色和 20+ 个任务流程。
| 角色 | 命令 | 职责 |
|---|---|---|
| 业务分析师 | /BMad/agents/analyst |
需求分析和业务建模 |
| 架构师 | /BMad/agents/architect |
系统架构设计 |
| 开发者 | /BMad/agents/dev |
代码实现 |
| 项目经理 | /BMad/agents/pm |
项目管理 |
| 产品负责人 | /BMad/agents/po |
产品决策 |
| QA工程师 | /BMad/agents/qa |
质量保证 |
| Scrum Master | /BMad/agents/sm |
敏捷流程 |
| UX专家 | /BMad/agents/ux-expert |
用户体验 |
| BMad大师 | /BMad/agents/bmad-master |
方法论指导 |
| BMad编排器 | /BMad/agents/bmad-orchestrator |
流程编排 |
# 架构师视角分析
/BMad/agents/architect 评估当前系统架构
# QA 视角审查
/BMad/agents/qa 审查测试覆盖率
# 多角色协作
/BMad/agents/bmad-orchestrator 组织架构评审会议| 命令 | 功能 |
|---|---|
/BMad/tasks/advanced-elicitation |
高级需求引导 |
/BMad/tasks/brownfield-create-epic |
棕地项目创建史诗 |
/BMad/tasks/brownfield-create-story |
棕地项目创建故事 |
/BMad/tasks/create-next-story |
创建下一个故事 |
/BMad/tasks/validate-next-story |
验证下一个故事 |
/BMad/tasks/review-story |
审查故事 |
| 命令 | 功能 |
|---|---|
/BMad/tasks/create-doc |
创建文档 |
/BMad/tasks/document-project |
项目文档 |
/BMad/tasks/index-docs |
索引文档 |
/BMad/tasks/shard-doc |
分片文档 |
| 命令 | 功能 |
|---|---|
/BMad/tasks/qa-gate |
QA 关口 |
/BMad/tasks/apply-qa-fixes |
应用 QA 修复 |
/BMad/tasks/test-design |
测试设计 |
/BMad/tasks/nfr-assess |
非功能性需求评估 |
| 命令 | 功能 |
|---|---|
/BMad/tasks/execute-checklist |
执行检查清单 |
/BMad/tasks/generate-ai-frontend-prompt |
生成 AI 前端提示 |
/BMad/tasks/trace-requirements |
追踪需求 |
| 命令 | 功能 |
|---|---|
/BMad/tasks/correct-course |
纠正路线 |
/BMad/tasks/risk-profile |
风险概况 |
/BMad/tasks/facilitate-brainstorming-session |
促进头脑风暴 |
/BMad/tasks/create-deep-research-prompt |
创建深度研究提示 |
/BMad/tasks/kb-mode-interaction |
知识库模式交互 |
创建新的 Claude Code 自定义命令,包含正确的 YAML frontmatter 和文档。
# 基本用法
/cc:create-command [command-name] [description]
# 示例
/cc:create-command code-review "自动化代码审查工具"- 项目级:
.claude/commands/[command-name].md - 用户级:
~/.claude/commands/[command-name].md
- ✅ 保持命令专注和单一目的
- ✅ 使用描述性名称
- ✅ 包含清晰文档和示例
- ✅ 在 frontmatter 中声明工具权限
自动检测并清理 AI 生成代码中的"冗余内容"(slop),确保代码库的整洁和专业性。
清理对象:
- ❌ 不必要的 Markdown 文件 (NOTES.md、PLAN.md、TODO.md 等)
- ❌ 冗余注释 (重复代码逻辑的注释)
- ❌ AI 生成的 TODO 注释
- ❌ 过度详细的 Docstrings
- ❌ Mock-heavy 的测试 (过度使用 Mock)
- ❌ 虚假数据 (没有来源的统计数据)
# 基本用法 - 对比当前分支与主分支
/de-slop
# 指定 PR 编号 - 对比特定 PR
/de-slop 1231. 上下文分析
确定对比基准:
- 与主分支对比 (默认)
- 与指定 PR 对比
2. 扫描 Slop 模式 (Dry Run)
- 不必要的 Markdown: NOTES.md, PLAN.md, ARCHITECTURE.md 等
- 冗余注释: 只是重复代码逻辑的注释
- AI TODO:
# TODO: Add error handling等模糊 TODO - 过度 Docstring: 简单函数却有 10+ 行文档
- Mock-Heavy 测试: 每个测试 >3 个
@patch - 虚假数据: 没有来源的具体百分比
3. 展示扫描结果
🔍 Found 5 slop patterns
[1] NOTES.md (45 lines)
→ Delete: Unnecessary markdown
[2] src/user.py:23-28
→ Remove redundant comments
[3] src/api.py:15-25
→ Simplify excessive docstring
[4] tests/test_user.py:50-70
→ Flag: Mock-heavy (5 mocks)
[5] docs/PLAN.md
→ Delete: Temporary planning document
Enter numbers (1 2 4), range (1-4), 'all', or 'none':
4. 执行清理
- 文件删除:
git rm NOTES.md - 代码清理: 使用 Edit 工具,展示 before/after
- 仅标记: 显示位置,询问是否查看
5. 清理总结
✅ Cleaned: 2 files deleted, 12 comments removed, 3 docstrings simplified
⚠️ Flagged: tests/test_user.py:50-70 (mock-heavy)
Next: Review flagged items, run tests, commit
- 总是先 Dry Run - 展示清理计划,等待确认
- 保护重要文件 - 永不删除 README.md、CONTRIBUTING.md
- 谨慎处理 - 不确定时标记而非删除
- 大规模确认 - 删除 >5 文件或 >50 行时再次确认
场景 1: 提交 PR 前清理
# 1. 完成功能开发
git commit -m "feat: add user authentication"
# 2. 运行 de-slop 清理
/de-slop
# 3. 选择清理项目
Enter numbers: all
# 4. 提交清理
git commit -m "chore: clean up AI-generated artifacts"
# 5. 推送 PR
gh pr create场景 2: 审查特定 PR
# 审查 PR #456
/de-slop 456
# 查看并清理
Enter numbers: 1 2
# 提交建议
gh pr comment 456 --body "Suggested cleanups applied"(详细文档已在前面的版本中提供,这里保持简洁)
智能化的 Git 提交工具,自动分析代码变更,创建符合 Conventional Commits 规范的提交。
# 基本用法
/gh-commit
# 带描述
/gh-commit "add YAML extraction support"- ✅ 自动分类变更 (feat/fix/docs/test/refactor)
- ✅ 智能批量处理
- ✅ Conventional Commits 格式
- ✅ 防止直接提交主分支
- ✅ 添加 Claude Code 署名
# 简单问题 → 直接回答
"这个函数做什么?"
# 复杂问题 → /think-harder
/think-harder 为什么性能下降了
# 极端复杂 → /think-ultra
/think-ultra 如何重新设计整个系统架构新功能开发流程:
# 1. 完整规划
/kiro:spec 用户认证功能
# 2. 详细设计
/kiro:design user-authentication
# 3. 生成任务
/kiro:task user-authentication
# 4. 执行任务
/kiro:execute user-authentication 1.1
# 5. 代码审查
/gh:review-pr [pr-number]
# 6. 清理代码
/de-slop
# 7. 智能提交
/gh-commit多角色讨论:
# 使用 Cook 多角色
/cook/multi-role architect,developer,qa
# 使用 BMad 专家
/BMad/agents/bmad-orchestrator 组织设计评审# 1. 全面分析
/sc:analyze
# 2. 识别问题
/cook/tech-debt
# 3. 系统改进
/sc:improve
# 4. 清理冗余
/sc:cleanup
# 5. 验证质量
/sc:test# 捕获突破
/eureka 发现了一个性能优化方案
# 会话反思
/reflection-harder
# 项目复盘
/sc:reflect- 🎯 简单任务: 直接提问
- 🔧 中等复杂: 使用专用命令 (
/cook/*,/sc/*) - 🏗️ 复杂项目: 使用框架 (
/kiro:*,/BMad/*)
- 📋 规划先行:
/kiro:spec或/cook/plan - 🎨 设计在前:
/kiro:design或/sc:design - 💻 实现在后:
/kiro:execute或/sc:implement - ✅ 测试验证:
/sc:test
- 🧹 定期清理:
/de-slop和/sc:cleanup - 📊 持续分析:
/sc:analyze - 🔄 不断改进:
/sc:improve
- 💡 捕获突破:
/eureka - 📝 文档化:
/sc:document - 🧠 定期反思:
/reflection或/reflection-harder
- 👥 多角色讨论:
/cook/multi-role或 BMad agents - 📋 规范提交:
/gh-commit - 🔍 认真审查:
/gh:review-pr
- ❌ 简单问题不要用
/think-ultra - ❌ 小改动不要用完整 Kiro 流程
- ❌ 不做设计直接编码
- ❌ 不做测试直接提交
- ❌ 不做审查直接合并
- ❌ 不运行
/de-slop就提交 PR - ❌ 积累技术债务不处理
- ❌ 不使用多角色视角审查
- ❌ 不记录知识和突破
Kiro:
- ✅ 完整新功能开发
- ✅ 需要详细规范和设计
- ✅ 多人协作项目
SC:
- ✅ 日常开发任务
- ✅ 代码改进和优化
- ✅ 快速迭代
Cook:
- 🍳 通用工具集
- 🎯 专注具体任务
- 🔧 独立使用
SC:
- 🤖 AI 辅助系统
- 🔄 完整开发流程
- 🔗 集成 MCP 和 Serena
适合:
- 📊 企业敏捷开发
- 👥 需要多角色协作
- 📋 规范化流程管理
不适合:
- 🚀 快速原型开发
- 🔧 个人小项目
文档版本: v2.0 最后更新: 2025-11-23 Commands 总数: 120+ 维护者: Claude Code Team
Commands 目录位置: .claude/commands/
反馈与建议: 如有问题或建议,请创建 GitHub Issue