Coze技能保存至GitHub：文件格式与完整存档教程

本文详细讲解Coze平台技能的标准文件结构、通用编写格式，以及将技能导出、本地整理、上传至GitHub的全流程。明确Coze技能以独立文件夹为载体，包含核心元数据文件SKILL.md、脚本资源、静态资产等文件，标准化结构可实现一键导出、备份、复用与跨设备导入。同时梳理极简Git上传操作命令，适配零基础用户，帮助使用者规范化托管Coze自定义技能，实现版本管理、永久备份与开源复用。

一、Coze 技能的标准格式（目录结构）

一个技能 = 一个文件夹，名字全小写、英文 / 数字 / 下划线，作为 skill_id。

my_skill/
├── SKILL.md          # 必选：元数据 + 说明（最重要）
├── scripts/          # 可选：代码（Python/Node.js 等）
│   └── main.py
├── references/        # 可选：参考文档、API、规范
└── assets/            # 可选：模板、静态文件
```{insert\_element\_0\_}

---

## 二、SKILL.md 标准格式（可直接复制用）
```markdown
---
name: 技能中文名称
skill_id: my_skill
version: 1.0.0
description: 一句话说明用途
tags: ["工具", "文案"]
---

# 技能名称

## 任务目标
- 解决什么问题
- 触发场景

## 执行流程
1. ...
2. ...

## 输入
- 文本：xxx
- 可选参数：xxx

## 输出
- 格式：Markdown / JSON
- 示例：

结果示例

plaintext

## 注意事项
- ...

---

三、把 Coze 技能保存到 GitHub（完整步骤）

1. 先把技能从 Coze 导出到本地

1. 进入 Coze → 技能 → 你的技能
2. 右上角：导出 / 下载 → 下载 .skill 或 zip
3. 解压得到上面的目录结构（含 SKILL.md）

2. 在 GitHub 建仓库

1. GitHub 新建仓库，例如 coze-skills
2. 不要勾选 "Initialize with README"（后面自己加）

3. 本地 git 上传（命令行）

bash

运行

# 进入你的技能目录
cd my_skill

# 初始化 git
git init

# 关联远程仓库
git remote add origin https://github.com/你的用户名/coze-skills.git

# 全部文件加入暂存
git add .

# 提交
git commit -m "feat: add my_skill"

# 推送
git push -u origin main

以后改了技能，重复：

bash

运行

git add .
git commit -m "update: xxx"
git push

4. 从 GitHub 导入回 Coze（双向）

1. Coze → 技能 → 导入
2. 选择 上传 zip /.skill 或直接关联 GitHub 仓库

---

四、关键点总结

• 技能本质 = 标准化文件夹 + SKILL.md扣子
• 可以直接 git 管理、存 GitHub、多人协作、开源
• 导入 Coze 时打包成 zip 或 .skill 即可识别