GitLink-Course-Creator

GitLink实践课程创建助手

GitLink 开源课程创建助手 - 在 CCF GitLink 平台自动化创建开源课程项目的 AI Agent Skill。

🚀 一句话安装

把下面这行直接发给你的 Agent（扣子bot），说「安装这个」：

https://xiaping.coze.com/skill/a43c79cc-c7c4-4028-a3f4-bdebd97b2739?ref=86d4db8d-b63f-45e0-a36c-cf410d13a60c

Agent 会自动完成安装配置，然后你提供 GitLink Token 就能用了。

功能特点

• 🤖 AI 自动解析：支持 PPTX、PDF、Markdown、DOCX、TXT、公众号链接等格式的材料自动解析
• 📚 标准化模板：提供标准化的 README 和 Issue 模板
• 🚀 一键部署脚本：scripts/setup-course.sh — 一条命令完成全流程
• 📦 案例仓库：examples/case/CCF-Suanli-Wool-Festival/ — 附带完整课程案例
• 🔧 Git CLI 优先：使用 Git 原生命令确保文件上传稳定性
• 🔒 公有/私有选择：创建项目时支持选择公有或私有仓库

文件结构

gitlink-course-creator/
├── README.md               # 本文件
├── SKILL.md                # 核心 Skill 定义文件
├── prompts.md              # AI Agent 提示词模板
├── checklist.md            # 创建检查清单
├── scripts/
│   ├── setup-course.sh     # 一键部署脚本（从零创建）
│   └── push-to-gitlink.sh  # 推送已有本地仓库到 GitLink
├── examples/
│   ├── sample-material.pptx  # 示例原始材料（CCF算力羊毛节）
│   ├── usage-examples.md     # 使用示例
│   └── case/
│       └── CCF-Suanli-Wool-Festival/  # 完整案例仓库（已初始化Git）
└── assets/

快速开始

方式一：AI Agent 模式（推荐老师使用）

直接上传课程材料（PPTX/PDF/MD/DOCX/TXT）给 AI Agent，AI 自动解析并完成所有工作。

不需要安装任何软件，老师只需：

1. 上传材料文件
2. 提供 GitLink Token
3. 确认 AI 推荐的课程方案

方式二：一键部署脚本（适合技术用户）

export GITLINK_TOKEN="your_token_here"

# 创建公有项目（默认）
bash scripts/setup-course.sh \
  --owner "your-org" \
  --repo "Course-Name" \
  --title "课程标题" \
  --description "课程简介" \
  --source "./examples/sample-material.pptx" \
  --chapters 5

# 创建私有项目（加 --private true）
bash scripts/setup-course.sh \
  --owner "your-org" \
  --repo "Course-Name" \
  --title "课程标题" \
  --description "课程简介" \
  --source "./examples/sample-material.pptx" \
  --chapters 5 \
  --private true

一条命令自动完成：环境检查 → 材料解析 → 仓库创建 → 内容上传 → Issue 创建。

方式三：使用案例仓库

export GITLINK_TOKEN="your_token_here"
bash scripts/push-to-gitlink.sh \
  --owner "your-org" \
  --repo "CCF-Suanli-Wool-Festival" \
  --local-path "./examples/case/CCF-Suanli-Wool-Festival"

前置要求

# 安装 GitLink CLI
npm install -g @gitlink-ai/cli

# 设置 Token（非交互环境）
export GITLINK_TOKEN="your_token_here"

# 验证
gitlink-cli version
gitlink-cli auth status

使用方法

1. 阅读 SKILL.md

了解完整的工作流程和命令参考。

2. 参考 prompts.md

使用提示词模板引导 AI Agent 执行。

3. 使用 checklist.md

在创建过程中进行验证和检查。

4. 查看 examples/

参考实际使用示例和案例仓库。

许可证

MIT License

更新日志

• v1.7.0 (2026-07-07): 新增公有/私有项目选择功能；支持DOCX、TXT、公众号链接等更多材料格式；repo +create 增加 --private true 参数；setup-course.sh 增加 --private 参数支持
• v1.5.0 (2026-07-06): 优先突出 AI Agent 模式（老师零安装）、新增组织归属检查流程、补充无组织分支处理
• v1.3.0 (2026-07-06): 新增一键部署脚本、推送脚本、案例仓库、完整端到端验证
• v1.2.0 (2026-07-05): 新增环境诊断(doctor)、非交互认证指南、分支处理策略、不登录可用操作清单
• v1.1.0 (2026-06-01): 强化 Git CLI 上传方案，沉淀自动解析材料功能
• v1.0.0 (2026-05-07): 初始版本

---

🧩 WorkBuddy 部署方式

本 Skill 已适配 WorkBuddy 插件市场格式，支持两种部署方式：

方式一：团队市场（推荐）

将本仓库配置为 WorkBuddy 的团队市场来源：

1. Fork 或直接使用本仓库：https://www.gitlink.org.cn/amylier/gitlink-course-creator-skill
2. 在 WorkBuddy 中配置团队市场地址指向本仓库
3. WorkBuddy 启动时自动拉取，Skill 即可用

方式二：提交到官方市场

Fork codebuddy/marketplace 仓库，按以下目录结构添加：

external_plugins/education/
├── .codebuddy-plugin/plugin.json
└── skills/
    └── gitlink-course-creator/
        ├── SKILL.md
        ├── reference.md
        └── scripts/

提交 PR 合并后，所有 WorkBuddy 用户均可通过市场搜索安装。

方式三：本地加载

# Clone 本仓库
git clone https://www.gitlink.org.cn/amylier/gitlink-course-creator-skill.git

# 在 WorkBuddy 中配置 skills 目录路径
# 指向 gitlink-course-creator-skill/external_plugins/education/skills/

目录结构

gitlink-course-creator-skill/
├── README.md                          # 本文件
├── SKILL.md                           # Coze 版 Skill 定义
├── skills/
│   └── gitlink-course-creator/        # GitLink CLI 兼容版
│       ├── SKILL.md
│       ├── reference.md
│       └── scripts/
└── external_plugins/
    └── education/                     # WorkBuddy 市场格式
        ├── .codebuddy-plugin/plugin.json
        └── skills/
            └── gitlink-course-creator/
                ├── SKILL.md
                ├── reference.md
                ├── examples/
                └── scripts/