page

name	page
description	Deploy the built course wiki site/ to GitHub Pages via gh CLI. Pre-checks gh auth status and site/ existence.
license	MIT
metadata	{"author":"WALKERKILLER","version":"1.1"}

Page (GitHub Pages 部署)

将已构建的课程 wiki 静态站点部署到 GitHub Pages。

When to Use

• User says /page or "deploy to pages" or "publish wiki".
• After running /wiki build and the site/ directory is ready.

Workflow

1. 前置检查 A: gh CLI 已安装

gh --version

如未安装，输出安装指引，引导用户访问 https://cli.github.com/ 安装。

2. 前置检查 B: gh 已认证

gh auth status

如未认证，引导用户执行 gh auth login 完成 GitHub 认证。

3. 前置检查 C: site/ 已构建

检查 workspace 的 site/index.html 是否存在：

ls <WORKSPACE_ROOT>/site/index.html

如 site/ 不存在或为空，引导先运行 /wiki build 构建站点。

4. 确定部署目标 repo

优先使用环境变量 GH_PAGES_REPO：

echo $GH_PAGES_REPO

如果未设置，从当前 git remote 推断：

git remote get-url origin

用户可在 .env 中设置 GH_PAGES_REPO=owner/repo 来指定目标仓库。

5. 部署到 gh-pages 分支

gh pages deploy <WORKSPACE_ROOT>/site/ --repo <TARGET_REPO> --branch gh-pages

要求 gh CLI 版本 >= 2.29.0。

6. 输出结果

部署完成后，GitHub Pages URL 格式为 https://<owner>.github.io/<repo>/。

Requirements

• gh CLI >= 2.29.0（安装: https://cli.github.com/）
• 已完成 gh auth login
• workspace 的 site/ 已通过 /wiki build 构建
• 目标 GitHub repo 已启用 GitHub Pages

Where <SKILL_DIR> Points

<SKILL_DIR> is the directory containing this SKILL.md. The /page command uses the gh CLI directly (no shared Python scripts needed). For other skills, shared scripts (look_tongji.py, timeline_tools.py, tongji_backend/) and references live two levels up in the repository root (<SKILL_DIR>/../../scripts/ and <SKILL_DIR>/../../references/).