在掌握参考型Skill的编写方法后，实战练习才是巩固技能的关键。本文将聚焦日常开发高频场景——Git代码提交，手把手教你编写一款可直接复用的任务型Skill，解决提交指令繁琐、提交描述难写的痛点，同时拆解任务型Skill的核心机制与编写要点，让你快速掌握其精髓，实现重复任务的高效简化。

任务型Skill

一、具体需求

先来说一个我每天都需要做的场景，就是每天像Github里提交代码。

git add .     // 增加所有代码
git commit -m "Someting description"  //编写代码修改描述
git push -u  origin master   //  合并到主仓库线上

最好的解决方法，就是我只敲一个"/Command",让Skill自己完成三个命令，特别是提交描述的编写（每次都让我头疼）。自动编写提交信息也是这个Skill的核心需求。

这也是任务型Skill的价值：把重复的对话模式，变成可复用的快捷方式。 如果在开发中经常重复的任务，你就可以考虑编写一个任务型Skill，来完成它。

二、任务型Skill的核心机制

任务型和参考型Skill的核心区别，就是任务型Skill需要设置disable-model-invocation:true（禁用模型调用）的关键选项。

我们在第09节，写的任务触发器，其实是可以自动触发的，但是我们加上这句话后，他就是一个更加完善的，并且只能手动触发的任务型Skill了。

.claude/skills/hello-jspang/     # skill 目录，名称即 skill 名
└── SKILL.md                        # 主文件（必需）
---
name: hello-jspang
description: 创建/更新HELLO_JSPang.md,用于验证skill能跑通闭环.
disable-model-invocation:true
---

## Instructions
...

如果你不使用disable-model-invocation:true是有可能错误触发技能的。所以这也算是任务型Skill的核心机制了。

三、创建/gitpush技能

当我们了解任务型Skill的核心机制后，还需要对它三要素有个基本的了解。

1.任务型技能的三要素

任务型技能的编写不像参考型的那么随意，需要一些必须项规定。所以就有了下面三要素。

任务型Skill

要素1：执行步骤， 我们必须描述它的执行步骤，第一步干什么，第二步干什么。

要素2：输出格式， 一般是输出的代码格式，如果需要知道执行结果，也可以输出执行结果。

要素3：注意事项， 这个不是必选项，但好的技能都会编写严谨的注意事项，这可以防止很多错误的发生。

当我们知道了这三个要素后，就可以自己动手编写一个任务型Skill了。

2.用户级Skill存放位置

还是以windows系统为例，要想创建一个用户级的Skill，存放的位置需要存放在用户下面，而不是项目下面。

    C:
    |-Users(用户)
      |-Administrator（根据你自己的用户找，我这里是管理员）
        |- .claude
           |-skills
             |-gitpush

因为技能的名字叫做gitpush,所以最后一层文件的名字也叫gitpush。

3.Skill源码

建立好文件夹之后（确定位置），就可以创建md文件了。文件的名字叫做SKILL.md.

---
name: gitpush
description: 自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括：自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。
disable-model-invocation:true
---

# GitPush 技能

自动完成 git 提交流程：暂存 → 生成提交信息 → 提交 → 推送到远程仓库。

## 执行步骤

### 1. 检查 git 状态
使用 `git status` 检查当前仓库状态，确认是否有可提交的内容。

### 2. 暂存更改
如果有待提交的文件，执行 `git add -A` 暂存所有更改。

### 3. 生成提交信息
执行 `git diff --cached --stat` 获取暂存的变更统计，然后：
- 如果有新增文件，提取新增文件的文件名
- 如果有修改文件，提取修改的文件名
- 根据变更内容生成简洁的提交信息，格式：`feat: 描述` / `fix: 描述` / `docs: 描述` / `chore: 描述`

### 4. 执行提交
使用生成的提交信息执行 `git commit -m "提交信息"`

### 5. 推送到远程
执行 `git push` 推送到远程仓库。如果当前分支没有上游跟踪，执行 `git push -u origin master` 设置上游并推送。

## 输出格式

### 成功时

✓ 提交成功！
- 提交信息: xxx
- 变更文件: x 个新增, x 个修改, x 个删除
- 耗时: x 秒
- 远程推送: 已完成


### 失败时

✗ 提交失败
原因: [具体错误信息]

可能的原因：
- 无可提交的内容（工作区干净）
- 未连接到远程仓库
- 远程仓库拒绝推送（权限问题或冲突）
- 网络连接失败


### 无需提交时

✓ 工作区没有可提交的内容

## 注意事项

1. 始终使用 `git add -A` 暂存所有更改
2. 提交信息使用中文，简洁明了
3. 推送到当前分支的远程对应分支
4. 如果推送失败，尝试显示具体的 git 错误信息
5. 记录每个步骤的耗时，最后汇总报告

最后总结

以上就是Git提交任务型Skill的完整编写流程，从核心机制、三要素到具体源码，每一步都贴合实际使用场景，可直接复制复用。掌握这款Skill，既能节省日常提交代码的时间，也能吃透任务型Skill的编写逻辑。后续可根据自身需求优化提交信息生成规则，解锁更多自定义功能，让技能真正适配自己的开发习惯。