步步图解

AI 工具

做你的第一个 Skill：把重复工作变成一条命令

把总要重复交代的流程写成 Skill，以后输入一条斜杠命令就能执行。

如果你发现自己总在重复粘贴同一段提示词，就该做一个 Skill 了。这篇教程会做一个生成周报的 Skill。

STEP 01 / 05

分清 Skill 和 CLAUDE.md

两者都是写给 Claude 看的说明，区别在于什么时候加载：

  • CLAUDE.md：每次会话都加载，放长期规则。
  • Skill：需要时才加载，放具体流程。

所以，“文案用简体中文”写进 CLAUDE.md，“周报怎么写”做成 Skill。

STEP 02 / 05

创建文件夹

Skill 是一个文件夹，里面必须有 SKILL.md。放在项目里，只有这个项目能用，也可以提交到 Git 共享：

PowerShell
mkdir .claude\skills\weekly-report

想让所有项目都能用，就放到个人目录 ~/.claude/skills/weekly-report/。

STEP 03 / 05

写 SKILL.md

在刚才的文件夹里新建 SKILL.md，内容如下：

SKILL.md
---
name: weekly-report
description: 根据本周的 Git 提交生成周报。用户要写周报或总结本周工作时使用。
disable-model-invocation: true
---

生成一份简体中文周报：

1. 运行 git log --since="7 days ago" --oneline 查看本周提交
2. 把提交归类为：完成的工作、进行中、遇到的问题
3. 用普通人能看懂的话描述，不罗列提交编号
4. 最后提出下周最重要的 3 件事
5. 写入 reports/ 文件夹，文件名用当天日期

文件开头两条 --- 之间是配置：

  • name：Skill 名称，也是斜杠命令的名字。
  • description：说明用途和使用时机。Claude 靠它判断什么时候该用。
  • disable-model-invocation: true：只有你手动输入命令才会运行。会写文件或有副作用的流程建议加上。

STEP 04 / 05

运行并调试

在 Claude Code 里输入：

Claude Code
/weekly-report

第一版通常不会完美。看结果哪里不对，就直接修改 SKILL.md 里的步骤。把模糊的要求改成具体的动作，效果最明显。

STEP 05 / 05

加入辅助文件

流程变复杂时，可以把模板、示例和脚本放进同一个文件夹，再在 SKILL.md 里引用：

文件结构
weekly-report/
├── SKILL.md
├── template.md
└── example.md

官方建议 SKILL.md 控制在 500 行以内，详细内容放到辅助文件里。

资料来源