56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
# create-skills
|
||
|
||
当工作过程中发现某些模式或流程可以显著提高效率，但目前没有 skill 覆盖时使用。
|
||
|
||
## 原则
|
||
|
||
不是所有重复操作都需要变成 skill。先问：这个模式是否通用到值得抽象？
|
||
|
||
## 流程
|
||
|
||
### 1. 识别模式
|
||
|
||
- 记录重复出现的操作序列
|
||
- 分析：每次都在做类似的什么事情？
|
||
- 评估：这个操作是否有通用性，还是只是当前任务的特例？
|
||
|
||
### 2. 评估是否值得做成 skill
|
||
|
||
- **值得做的特征**：
|
||
- 同一个操作在不同 agent/workspace 中重复出现
|
||
- 操作步骤固定，结果可预期
|
||
- 涉及外部系统调用（git、keycloak、文件操作等）
|
||
- **不值得做的特征**：
|
||
- 一次性任务
|
||
- 步骤不固定，依赖上下文判断
|
||
- 纯对话/分析类工作
|
||
|
||
### 3. 设计 skill
|
||
|
||
- **名称**：`{action}-{target}`（如 `git-clone-repo`、`keycloak-create-user`）
|
||
- **SKILL.md 内容**：
|
||
- 描述：这个 skill 做什么
|
||
- 使用场景：什么时候用
|
||
- 脚本列表：所有相关脚本及其调用方式
|
||
- **脚本**：
|
||
- 放在 `scripts/` 下
|
||
- 每个脚本单一职责
|
||
- 提供 `--help` 或 `-h` 支持
|
||
|
||
### 4. 实现
|
||
|
||
- 编写脚本，测试通过
|
||
- 编写 SKILL.md
|
||
- 本地验证
|
||
|
||
### 5. 提交
|
||
|
||
- 按 promote-improvements 流程提交到自己的分支
|
||
- commit message 包含：skill 名称、功能描述、使用示例
|
||
- 通知 hang，说明新增 skill 的用途
|
||
|
||
### 6. 上线
|
||
|
||
- hang merge 后，skill 进入 ClawSkills 正式列表
|
||
- 其他 agent 通过 learn.sh 自动获取
|