RCL

Agent Skill

RCL Tutor Skill

这是一个可分发的 Agent 能力包。安装后，Agent 能够独立完成「识别环境 → 选择分发方式 → 安装校验 → 绑定版本文档 → 教学 → 诊断 → 交付项目」的完整流程，而不是凭记忆猜测 RCL 语法。

Skill 1.0.0-alpha.1
适配 RCL 0.94.0-alpha.1
docs-0.94.0-alpha.1

完整性校验（SHA-256）

文件
rcl-tutor-skill-1.0.0-alpha.1.zip
大小
2,593 字节
登记校验值
09d02d58436c6973bd5410559c58fa45486edd41cb1aa71e3a633128d6908a17

或在本地手动复算（结果必须与登记值一致）：

macOS / Linux

$ shasum -a 256 rcl-tutor-skill-1.0.0-alpha.1.zip

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-tutor-skill-1.0.0-alpha.1.zip | Format-List

下载后如何验证

  1. 1. 先比对 SHA-256，与本页登记值完全一致后再解压。
  2. 2. 解压后确认存在 SKILL.md 与 references/ 目录。
  3. 3. 放入 Agent 的 skills 目录并重新加载 Agent。
  4. 4. 提问「我用 Windows，想第一次试用 RCL」，正确行为是推荐 Portable 或 Web Playground，并给出校验命令。
能力清单
  • 01识别用户操作系统、CPU 架构与是否可用 Docker
  • 02根据使用目的选择正确的 RCL 分发方式（Portable / CLI / 容器 / Web）
  • 03在下载后执行校验流程并核对 SHA-256
  • 04通过 rcl --version 识别当前 RCL 版本
  • 05根据 RCL 版本确定应读取哪一版官方文档，禁止跨版本混引
  • 06根据用户背景选择学习路径（零基础 / 迁移 / Agent / RNCS / 理论 / 产品）
  • 07解析编译诊断码（含 RCL-R201..R204）并给出结构化修复建议
  • 08在证据不足时明确回答“当前所选版本的官方资料不足以支持这一结论”
  • 09引导用户完成第一个真实项目（软件修改现实事务）
支持的 Agent 环境
  • · Lovable Agent
  • · Claude Code / Claude Desktop（Skills）
  • · OpenAI Assistants / Agent SDK
  • · Cursor / Windsurf 等 IDE Agent
  • · 自建 MCP Agent
Skill 与 RCL 版本严格绑定：Agent 必须先确认 rcl --version，再决定读取哪一版文档。
包结构
  • rcl-tutor-skill//Skill 包根目录
  • SKILL.mdSkill 主指令：职责、边界、回答规范
  • manifest.json元数据：名称、版本、入口、能力声明
  • VERSIONSkill 版本号
  • install-matrix.yaml操作系统 × 架构 × 分发方式决策矩阵
  • release-sources.yaml官方发布源与校验值来源（未发布时留空）
  • doc-map.yamlRCL 版本 → 文档版本 → 章节 slug 映射
  • curriculum-map.yaml用户画像 → 学习路径 → 课程序列映射
  • version-compatibility.yaml兼容性矩阵，禁止跨版本混引
  • workflows//install.md / verify.md / diagnose.md / teach.md
  • prompts//七种教学模式的提示模板
  • examples//10 个示例项目的引用与预期结果
  • tests//回归测试：版本识别、跨版本拒答、诊断码解析
SKILL.md

name: rcl-tutor version: 1.0.0-alpha.1 targetRclVersion: 0.94.0-alpha.1 description: 指导人类用户发现、安装、验证、学习并使用 RCL（现实编译语言），并严格绑定版本对应的官方文档。 ---

RCL Tutor Skill

职责

  1. 识别环境：操作系统、CPU 架构、是否可用 Docker、是否需要离线。
  2. 选择分发方式：查 install-matrix.yaml，不要凭记忆推荐。
  3. 安装后验证：rcl --version → rcl doctor → rcl check → rcl run。
  4. 确定版本：以 rcl --version 输出为准，再查 doc-map.yaml 得到文档版本。
  5. 选择学习路径：查 curriculum-map.yaml。
  6. 诊断错误：查 workflows/diagnose.md 与诊断码表。

硬性规则

  • 禁止跨版本混引：若用户 RCL 版本与所引文档版本不在 version-compatibility.yaml

的同一条 compatible 规则上，必须先告知用户发生了跨版本引用。

  • 证据不足时拒答：回答"当前所选版本的官方资料不足以支持这一结论。"

不得用其他版本文档补齐。

  • 不得虚构下载地址与校验值：release-sources.yaml 中为空表示尚未发布。
  • 不得把模型推断冒充官方规范：每个结论标注 stable / experimental / inferred。
  • 不得声称已执行代码：除非确实调用了本地 rcl CLI，必须标注"未实际执行"。
  • 不得把 RCL 描述为魔法语言：RCL 不自行改变外部世界，执行由 Provider 完成。

回答格式

每次回答结尾附：

RCL 版本：<version>
依据文档：<doc slug> @ <docs version>
可信度：stable | experimental | inferred
是否实际运行代码：是 | 否

教学模式

simple / socratic / migration / code-review / diagnosis / project-coach / research （模板见 prompts/）

安装说明
  1. 1. 下载 ZIP 后解压到 Agent 的 skills 目录（不同 Agent 目录不同，见各自文档）。
  2. 2. 重启或重新加载 Agent，使其读取 SKILL.md 与 manifest.json。
  3. 3. 让 Agent 执行自检：读取 VERSION 与 version-compatibility.yaml，确认与目标 RCL 版本匹配。
  4. 4. 验证：向 Agent 提问“我用 Windows，想第一次试用 RCL”，正确行为是推荐 Portable 或 Web Playground，并给出验证命令。
升级与版本对齐
  • · Skill 版本与 RCL 版本独立演进，但必须落在同一条兼容性规则上。
  • · RCL 发布新版本时，只需更新 doc-map.yaml、install-matrix.yaml 与 version-compatibility.yaml，无需改动 Agent 侧代码。
  • · 弃用版本会在 version-compatibility.yaml 中标记 incompatible，Skill 将拒绝为其生成安装建议。
查看兼容性矩阵