Page

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 /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 /site/ --repo  --branch gh-pages

要求 gh CLI 版本 >= 2.29.0。

6. 输出结果

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

Requirements

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

Where `` Points

` 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 (looktongji.py, timelinetools.py, tongji_backend/) and references live two levels up in the repository root (/../../scripts/ and /../../references/`).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: WALKERKILLER
• Source: WALKERKILLER/Look-Tongji-Notes
• License: MIT
• Homepage: https://github.com/WALKERKILLER/Look-Tongji-Notes

Install and usage instructions live in the source repository linked above.