内置技能参考（Bundled Skills Reference）

概述

Claude Code 自带 5 个内置技能，覆盖最常见的工作流。它们开箱即用，无需安装。

/batch — 大规模并行变更

用途

跨代码库编排大规模并行变更。将工作分解为 5-30 个独立单元，每个单元在隔离的 Git 工作树（worktree）中并行执行。

使用方式

/batch 将所有 React 类组件转换为函数组件

/batch 为 src/api/ 下的每个端点添加输入验证

工作原理

1. Claude 分析代码库，识别需要变更的文件/模块
2. 将工作分解为独立的处理单元
3. 为每个单元创建独立的 Git 工作树
4. 多个子代理并行执行变更
5. 合并结果到主分支

适合场景

• 跨文件重命名/重构
• 批量添加类型注解
• 统一代码风格
• 迁移 API 版本
• 批量更新配置

注意事项

• 每个单元应该是独立的（不相互依赖）
• 适合 5-30 个单元，太少不值得并行，太多管理开销大
• 需要 Git 仓库支持

/simplify — 代码质量审查

用途

审查最近变更的文件，检查代码复用机会、质量问题和效率改进。生成 3 个并行审查代理。

使用方式

/simplify

/simplify 关注性能优化

工作原理

1. 识别最近修改的文件
2. 启动 3 个并行审查代理：
   • 复用审查：查找重复代码和可提取的公共模式
   • 质量审查：检查命名、结构、错误处理
   • 效率审查：发现性能问题和不必要的复杂度
3. 汇总报告，提出具体改进建议

适合场景

• 功能开发完成后的自检
• PR 提交前的质量把关
• 重构后确认没有遗留问题

/loop — 定时循环执行

用途

按设定间隔反复运行提示或技能。适合轮询、监控、定期检查等场景。

使用方式

/loop 5m 检查部署状态并报告

/loop 2h /simplify

/loop 30s 运行 npm test 并报告失败的测试

间隔语法

• 30s — 30 秒
• 5m — 5 分钟（默认 10 分钟）
• 2h — 2 小时

注意事项

• 会话级别作用域，3 天自动过期
• 每个会话最多 50 个定时任务
• 也可以用自然语言设置一次性提醒

/debug — 会话调试

用途

排查当前会话的问题。读取调试日志，分析错误原因。

使用方式

/debug

/debug 为什么上一个命令失败了

工作原理

1. 读取当前会话的调试日志（transcript.jsonl）
2. 分析最近的工具调用和错误
3. 提供诊断和建议

适合场景

• 工具调用失败原因不明
• Claude 的行为不符合预期
• 需要理解会话中发生了什么

/claude-api — API 参考

用途

为你的项目语言加载 Claude API 参考资料和 Agent SDK 参考。

使用方式

/claude-api

工作原理

1. 检测项目使用的编程语言
2. 加载对应的 Claude API 文档
3. 加载 Agent SDK 参考（如适用）
4. 提供代码示例和最佳实践

适合场景

• 集成 Claude API 到你的应用
• 使用 Anthropic SDK（Python/TypeScript）
• 构建基于 Agent SDK 的自定义代理

GitHub 内置命令

除了 5 个内置技能，Claude Code 仓库还提供 3 个示例命令：

这些可以作为自定义技能的参考模板。