Regulus Academy

Appearance

Coach Skill 下载与 Agent 练习 ​

在 OpenClaw、Cursor 等 Agent 环境中，用 Regulus 教练做 讲解 → 练习 → 批改 闭环，无需一直开着浏览器。

获取 Skill 包（lite） ​

  1. 打开 Regulus 主页，点击右上角 「Skill 下载」
  2. 下载 regulus-coach.zip（约几 MB，不含 CLI 二进制）并解压到 Agent skills 目录

包内说明：

文件用途
SKILL.mdAgent 必读：模式选择、流程
USAGE.md安装、建课、会话完整教程
protocol-lite.mdAgent-lite 精简协议
agent-prompts.md讲解 / 出题 / 批改要点
scripts/api-session.shLinked 模式 HTTP 会话
schemas/exercise / grade / progress（lite 子集）
domains/内置公共课程

可选 regulus CLI（与 Web 同状态机）：Skill 内 bash scripts/install-cli.sh 或 GitHub Releases。

三种模式 ​

mermaid
flowchart TD
  start[用户要学某课] --> checkLink{有 link.json?}
  checkLink -->|是| linked[Linked: api-session.sh]
  checkLink -->|否| checkCLI{有 bin/regulus?}
  checkCLI -->|是| cli[CLI: regulus session]
  checkCLI -->|否| lite[Agent-lite: protocol-lite]
  linked --> api[远程 HTTP API]
  cli --> local[本地 SQLite]
  lite --> progress[data/progress.json]
模式条件教练逻辑进度
Linked（推荐）.regulus/link.jsonscripts/api-session.sh服务端
CLI（可选）bin/regulus + Keyregulus session本地 DB，可 sync
Agent-lite默认protocol-lite + schemasdata/progress.json

快速开始（Linked，已部署 Regulus） ​

bash
cd regulus-coach
cp .regulus/link.json.example .regulus/link.json
# 编辑 apiUrl、userId

bash scripts/api-session.sh start --slug go-concurrency
bash scripts/api-session.sh message --session <id> "开始练习"

对 Agent 说「我想学 Go 并发」时：检查 domains/ → 缺课则 build-domain.sh → 有 link 则走 api-session.sh。

推荐

已部署 Regulus 的用户优先 Linked 模式，与 Web 共用进度与完整状态机。

快速开始（Agent-lite，纯离线） ​

  1. 读 domains/<slug>/nodes/<key>.yaml 与 agent-prompts.md
  2. 按 protocol-lite.md 讲解 → 出题 → 批改
  3. 节点通过后更新 data/progress.json

Linked / CLI 模式下 Agent 不得即兴编造讲解或练习题。

可选 CLI ​

不在 Web 主页提供下载。解压 Skill 后，Agent 首次使用会说明三种模式；若需要 CLI，在 Skill 根目录执行：

bash
bash scripts/install-cli.sh          # 有 link.json 时从实例拉取
bash scripts/install-cli.sh --github
chmod +x bin/regulus
./bin/regulus doctor

平台：darwin_arm64、darwin_amd64、linux_amd64、linux_arm64。

叠加你在 Web 建的课 ​

  1. 课程详情 「导出 Domain 包」 → {slug}-domain.zip
  2. 解压后将 {slug}/ 复制到 regulus-coach/domains/

与 Web 同步进度（CLI） ​

bash
./bin/regulus link --url https://你的-regulus-地址 --user-id default
./bin/regulus sync pull
./bin/regulus sync push

命令参考 ​

bash
bash build-domain.sh "想学 TypeScript"
bash scripts/api-session.sh start --slug <slug>
bash scripts/api-session.sh message --session <id> "用户原话"
./bin/regulus session start --slug <slug>    # 可选 CLI

开发者在仓库根目录 make cli 构建 bin/regulus。

延伸阅读 ​