GitLink 开源课程创建助手 (GitLink-Course-Creator)

一个面向 CCF GitLink 平台的 AI Agent Skill，把”老师提供原始材料 → 自动生成标准化开源课程仓库”做成一条流水线。

面向受众

本项目主要服务以下四类用户。如果你属于其中之一，可以直接跳到对应的使用章节。

🎓 1. 高校教师 / 高校课程组

痛点：想把自己的课程（PPT、PDF、讲义）做成开源项目，让学生 / 其他学校复用，但手工建仓库、写 README、建学习打卡 Issue 太繁琐。
本项目如何帮忙：把原始材料（一份 PPTX/PDF 即可）丢给支持本 Skill 的 AI Agent，5 分钟内得到一个完整的开源课程仓库：仓库 + README + 学习任务 Issue 全自动生成。
典型场景：MOOC 同步开课、跨校共享课件、申报开源课程示范项目。

🧑‍🏫 2. 知识工作者 / 企业培训师

痛点：需要给团队 / 客户做培训，资料散落在 PPT、Confluence、个人笔记里，缺乏一个统一的”开源版”沉淀。
本项目如何帮忙：把培训材料按本 Skill 的工作流初始化成仓库后，培训资料的版本管理、协作更新、对外分享都有了标准形态。
典型场景：公司内训资料开源版、社区读书会、技术布道材料库。

🤝 3. 组队学习活动组织者（如 CCF 领航计划、AI 普惠课程）

痛点：组队学习通常按周布置任务，需要仓库 + 学习打卡 Issue + 进度追踪；每开一期都重复造轮子。
本项目如何帮忙：用本 Skill 一次性把学习路线、章节任务、Issue 模板全建好，组织者只负责”喊人 + 收作业”。
典型场景：CCF 开源普惠教育、AI Infra 组队学习、读书会、Workshop。

🛠️ 4. 开源课程开发者 / 教育开源贡献者

痛点：想贡献 CCF GitLink 教育专区的开源课程，希望有一套”快速初始化”模板，避免每次都从零写 README / Issue。
本项目如何帮忙：直接 fork 本仓库，改 prompts.md / SKILL.md / checklist.md 适配你自己的课程结构；或者在 AI Agent 中加载本 Skill，让 Agent 帮你跑完整流程。

项目能做什么

能力	说明
📥 材料自动解析	输入 PPTX / PDF / Markdown / DOCX，自动提取课程标题、简介、章节结构、目标学习者
📦 仓库自动创建	通过 GitLink CLI 或 REST API 一键创建课程仓库
📝 README 自动生成	基于标准 8 段式模板（概述 / 目标 / 受众 / 结构 / 实操 / 打卡 / 共创 / 许可）生成专业 README
✅ 学习任务 Issue 自动创建	按章节自动批量创建【打卡】Issue，配套四段式标准模板（任务目标 / 你要做什么 / 评论分享 / 参考内容）
🛡️ Git 原生命令兜底	关键文件上传用 `git push` 而非 API，绕过”文件已存在”等限制
🧩 可二次定制	`prompts.md` / `checklist.md` 都是可改文本，按需调整适配你的课程结构

如何使用

下面给出两种使用方式，任选其一即可。

方式一：在 AI Agent 中加载本 Skill（推荐 ⭐）

适用场景：你已经在用 Claude Code / OpenClaw / Cursor 等 AI Agent 工具，希望用对话方式创建课程。

Step 1：安装本 Skill

# 把仓库克隆或下载到 AI Agent 的 skills 目录
git clone https://www.gitlink.org.cn/<your-username>/GitLink-Course-Creator.git

# 或者直接把仓库 zip 解压到：
#   Claude Code:  ~/.claude/skills/gitlink-course-creator/
#   OpenClaw:     ~/.openclaw/skills/gitlink-course-creator/
#   Mavis:        ~/.mavis/skills/gitlink-course-creator/

Step 2：向 Agent 提交课程材料

直接对 Agent 说：

我有一份课程 PPTX 文件，请帮我创建开源课程项目。附件：AI论文写作实战.pptx 组织：Lab4AI

Agent 会自动：

解析 PPTX，提取课程标题 / 简介 / 章节结构 / 目标学习者
生成课程大纲建议（你可以审核调整）
确认信息后执行仓库创建
推送 README 和示例 Issue

Step 3：审核与发布

在 GitLink 网页端打开自动生成的仓库，检查 README 与 Issue
如有调整，编辑仓库内容后提交
把仓库链接分享给目标学习者

方式二：在命令行中按工作流手动执行

适用场景：你偏好脚本化、想把流程接入 CI / 自动化流水线。

前置准备

# 1. 安装 GitLink CLI（可选，强烈推荐）
npm install -g @gitlink-ai/cli

# 2. 登录认证（任选其一）
gitlink-cli auth login                                  # 交互式
gitlink-cli auth login --token                          # Token 粘贴
export GITLINK_TOKEN="<your-personal-access-token>"     # 环境变量（CI 推荐）

# 3. 验证认证
gitlink-cli auth status

工作流 5 步

# Step 1: 自检 + 自动安装（如缺 gitlink-cli 则尝试 npm 装上）
# （由本仓库的 Skill 自动完成）

# Step 2: 创建课程仓库
gitlink-cli repo +create \
  --owner <your-username> \
  --name <course-repo-name> \
  --description "<course-description>"

# Step 3: 克隆仓库到本地
git clone https://www.gitlink.org.cn/<your-username>/<course-repo-name>.git
cd <course-repo-name>

# Step 4: 用本仓库的 README 模板 / Issue 模板填充内容，提交推送
git add .
git commit -m "chore: add comprehensive README"
git push origin master

# Step 5: 批量创建学习打卡 Issue
for i in {1..3}; do
  gitlink-cli issue +create \
    --owner <your-username> \
    --repo <course-repo-name> \
    --title "【打卡】任务$i：章节$i" \
    --body "..."
done

提示词模板

参考 prompts.md — 内含完整的 AI Agent 提示词模板（结构化输入 / 解析引导 / 用户确认 / 执行命令）。

检查清单

参考 checklist.md — 创建过程中每一步的验证项，避免漏掉关键步骤。

完整使用示例

参考 examples/usage-examples.md — 真实案例 + 命令片段 + 排错指南。

仓库结构

GitLink-Course-Creator/
├── README.md              # 本文件（面向用户）
├── SKILL.md               # Skill 核心定义（面向 AI Agent）
├── prompts.md             # AI Agent 提示词模板
├── checklist.md           # 创建流程检查清单
├── LICENSE                # MIT 开源许可证
├── assets/                # 静态资源（图标、模板截图等）
└── examples/
    ├── sample-material.pptx   # 示例原始材料
    └── usage-examples.md      # 完整使用示例

工作流概览

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  1. 用户输入    │───▶│  2. AI 解析材料  │───▶│  3. 用户确认    │
│  材料 + 必要信息 │    │  (PPTX/PDF/MD)  │    │  课程大纲建议   │
└─────────────────┘    └─────────────────┘    └────────┬────────┘
                                                       │
┌─────────────────┐    ┌─────────────────┐    ┌────────▼────────┐
│  6. 学习者加入   │◀───│  5. 推送 README  │◀───│  4. 创建仓库    │
│  Issue 打卡     │    │  + Issue 模板   │    │  + 章节 Issue   │
└─────────────────┘    └─────────────────┘    └─────────────────┘

配套工具与依赖

工具	用途	是否必须
Git	版本控制 + push 兜底通道	✅ 必须
Node.js 14+	运行 GitLink CLI	⚠️ 推荐（非必须，REST API 也可）
GitLink CLI	仓库 / Issue / PR 操作	⚠️ 推荐（可用 REST API 替代）
AI Agent	加载本 Skill 后自动化全流程	⭐ 强烈推荐

GitLink CLI 仓库：https://www.gitlink.org.cn/Gitlink/gitlink-cli

共创与贡献

欢迎所有教育工作者 / 知识工作者 / 开源贡献者参与共建！

贡献方式：

🐛 提交 Issue 反馈问题或建议（用 enhancement / bug 标签）
🔧 提交 Pull Request 完善文档、模板、Skill 逻辑
🌟 Star / Fork 本仓库，分享给身边需要的人
📚 用本 Skill 创建课程后，把仓库链接发到 Issue 区，互相推广

贡献前必读：

PR 前请阅读 checklist.md 中的”发布前自检”清单
Skill 逻辑变更请同步更新 SKILL.md 和 prompts.md
新增示例请放到 examples/ 并在 usage-examples.md 中索引

开源许可证

本项目采用 MIT License 开源许可证。

MIT License

Copyright (c) 2026 CCF GitLink 开源普惠教育

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

完整协议文本见 LICENSE 文件。

更新日志

v1.1.0（2026-06-01）

强化 Git CLI 上传方案，沉淀自动解析材料功能
README 升级为 8 段式标准模板（覆盖受众 / 学习目标 / 章节 / 实操 / 打卡 / 共创 / 许可）

v1.0.1（2026-05-07）

组织字段调整为必填
许可证字段调整为可选

v1.0.0（2026-05-07）

初始版本发布

常见问题

Q1: 没有 Node.js / npm 可以用吗？

可以。本 Skill 的核心逻辑都在 SKILL.md 中描述，AI Agent 加载后可以直接通过 REST API（GitLink 基于 Gitea）+ git push 完成所有操作，不强制依赖 CLI。

Q2: Token 在哪里生成？

GitLink 网页端 → 右上角头像 → 设置 → 私人令牌 → 生成新令牌（勾选 repository 和 user 权限即可）。

Q3: 创建的仓库能直接放在组织下吗？

GitLink CLI 的 --owner 参数当前会把仓库创建到认证用户的个人账户下。如需迁移到组织，在 GitLink 网页端 → 仓库 → 设置 → 转让即可。

Q4: README 第一次创建失败怎么办？

GitLink API 在仓库首次创建时会自动生成一个默认 README，后续 API 拒绝覆盖。使用 Git 原生命令（git add + git commit + git push）绕过此限制，详见 SKILL.md Step 3。

Q5: 想自定义 Issue 模板怎么办？

编辑 SKILL.md 中的 “Issue 学习任务模板” 段，或在 prompts.md 中修改对应的提示词即可。本 Skill 的所有模板都是可改文本。

联系方式

项目维护：CCF GitLink 开源普惠教育
平台支持：CCF 开源发展技术委员会（ODTC）
项目主页：https://www.gitlink.org.cn/
问题反馈：Issues

如果本项目帮你把课程更快地做成开源项目，欢迎点个 ⭐ Star 鼓励一下！