官方教程中文版扩展与自动化
使用 Skills
用 Claude Code Skills 沉淀重复工作流、参考资料和可调用命令。
Skill 是 Claude Code 推荐的通用扩展单元。它用一个 SKILL.md 描述能力，Claude 可以在相关任务中自动加载，也可以由你用 /skill-name 直接调用。
适合做成 Skill 的内容：
- 反复粘贴的多步 checklist。
- 长参考资料，例如 API 约定、部署手册、团队风格。
- 可调用流程，例如
/deploy、/review、/release-note。 - 需要模板、示例、脚本或附属文件的工作流。
放在哪里
Skill 的位置决定作用域：
~/.claude/skills/<skill-name>/SKILL.md 个人全局
.claude/skills/<skill-name>/SKILL.md 当前项目
<plugin>/skills/<skill-name>/SKILL.md 插件作用域同名时，企业管理配置优先，然后是个人、项目、插件。插件 skill 会带命名空间，避免和本地 skill 冲突。
最小结构
---
description: Summarizes uncommitted changes and flags risky edits.
---
## Current changes
!`git diff HEAD`
## Instructions
Summarize the diff, list risks, and say whether tests should be added.这里的 ! 命令属于动态上下文注入。Claude 在读取 skill 前先执行命令，把结果插进 skill 内容里。适合把当前 diff、测试结果、环境状态带入工作流。
Invocation 策略
Skill 可以自动触发，也可以只允许人工调用。写 skill 时先判断它属于哪类：
- 参考型：可以自动加载，例如 API 风格、代码规范。
- 任务型：通常人工调用，例如部署、发布、迁移。
- 高风险任务：建议禁止模型自动调用，只允许你显式输入
/skill-name。
和旧 Commands 的关系
Claude Code 官方文档说明：自定义 commands 已经合并进 skills 机制。.claude/commands/deploy.md 仍可用，但 Skill 提供更完整的目录结构、frontmatter、附属文件和自动加载能力。
新写内容优先用 Skill；旧 commands 可以逐步迁移。