@sokeai/cli 1.0.78 → 1.0.80

package/skills/multi/soke-ai-coach-director/references/exec-part1.md

@@ -23,7 +23,7 @@
   "description": "<场景描述全文，完整搬运不缩略>",
   "tags": ["标签1", "标签2", "标签3"],
   "key_points": "1) 考核点1；2) 考核点2；3) 考核点3",
-  "scene_lang": "简体中文",
+  "scene_lang": "zh",
   "scenario_cover": "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 }
 ```
@@ -36,7 +36,7 @@
 | `description` | string | Part1 场景描述全文，禁缩略 | 只写首句摘要 |
 | `tags` | string[] | 3-5 个数组元素 | ❌ 逗号分隔字符串 |
 | `key_points` | **string** | 多条用分号/编号拼成**单字符串** | ❌ 写成数组（平台会接受但字段为空） |
-| `scene_lang` | string | 固定 `"简体中文"`（永不随场景变） | ❌ `"zh-CN"` / `"中文"` |
+| `scene_lang` | string | 仅支持 `zh`、`tw`、`en`（分别为简体中文、繁体中文、英文） | ❌ `"简体中文"` / `"zh-CN"` / `"中文"` |
 | `scenario_cover` | string | 固定默认图 URL | ❌ 占位/本地路径 |
 
 ---
@@ -48,7 +48,7 @@ assert isinstance(data["name"], str) and 1 <= len(data["name"]) <= 100
 assert isinstance(data["description"], str) and len(data["description"]) >= 20
 assert isinstance(data["tags"], list) and 3 <= len(data["tags"]) <= 5
 assert isinstance(data["key_points"], str) and len(data["key_points"]) > 0
-assert data["scene_lang"] == "简体中文"
+assert data["scene_lang"] in {"zh", "tw", "en"}
 assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 ```
 
@@ -63,8 +63,8 @@ assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cov
 ❌ 案例 B：tags 写成逗号分隔字符串
 { "tags": "展会拓客,B2B销售,快速识别" }
 
-❌ 案例 C：scene_lang 写成 zh-CN
-{ "scene_lang": "zh-CN" }
+❌ 案例 C：scene_lang 使用不支持的展示名称或区域码
+{ "scene_lang": "简体中文" }
 
 ❌ 案例 D：封面留空或写占位 URL
 { "scenario_cover": "" }

package/skills/multi/soke-ai-coach-director/references/platform-api-pitfalls.md

@@ -41,7 +41,7 @@
 - **验收**：apply 后 `+get-scenario --raw` 逐字段核对目标字段；preview/apply 成功≠平台最终解析正常。
 - **JSON 中文引号**：用 Python `json.dump(ensure_ascii=False)` 写入，禁 heredoc/echo（全角双引号会报错）。
 - **类型**：Part3 `max_rounds` 整数、`sort_order` 字符串 `"1"`；Part4 `sort_order` 数字 `1`（两者相反）。
-- **Part1 必填**：`key_points` 是字符串（非数组）、`scene_lang="简体中文"`、`scenario_cover` 固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`。
+- **Part1 必填**：`key_points` 是字符串（非数组）、`scene_lang` 为 `zh/tw/en` 之一、`scenario_cover` 固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`。
 - **身份字段**：`corp_id/user_id/implementation_corp_id` 禁写请求体，不作选租户依据。
 
 ## 推荐顺序

package/skills/multi/soke-ai-coach-director/references/self-improvement-examples.md

@@ -64,10 +64,12 @@ Use `pnpm install` for this project.
 ### Resolution
 - **Resolved**: 2025-01-15T14:30:00Z
 - **Commit/PR**: N/A - knowledge update
+- **Notes**: Added to CLAUDE.md for future reference
 
 ---
 ```
 
+## Learning: Promoted to CLAUDE.md
 
 ```markdown
 ## [LRN-20250115-003] best_practice
@@ -75,6 +77,7 @@ Use `pnpm install` for this project.
 **Logged**: 2025-01-15T16:00:00Z
 **Priority**: high
 **Status**: promoted
+**Promoted**: CLAUDE.md
 **Area**: backend
 
 ### Summary

package/skills/multi/soke-ai-coach-director/references/self-learning-engine.md

@@ -464,6 +464,10 @@ grep -B5 'Priority\*\*: high' .learnings/*.md | grep '^## \['
 
 | 文件 | 用途 |
 |------|------|
+| `scripts/activator.sh` | 每轮对话后提醒评估学习(可选启用) |
+| `scripts/error-detector.sh` | 命令执行失败时自动检测并提示记录 |
+| `scripts/extract-skill.sh` | 从 learning 提取为新 skill |
+| `scripts/sync.sh` | Part3-5 统一脚本代理执行器(统一返回 success/failed/fail_stage/next_action/updated_at/validation_result) |
 | `assets/LEARNINGS-TEMPLATE.md` | 学习条目记录模板 |
 | `assets/ERRORS-TEMPLATE.md` | 错误条目记录模板 |
 | `assets/FEATURE_REQUESTS-TEMPLATE.md` | 功能请求记录模板 |

package/skills/multi/soke-ai-coach-director/references/subs/part1/SOP.md

@@ -4,7 +4,7 @@
 
 ## 固定约束
 
-- 场景语言 `scene_lang` 固定 `"简体中文"`（永不随场景变）。
+- 场景语言 `scene_lang` 仅支持 `zh`（简体中文）、`tw`（繁体中文）、`en`（英文）。
 - 封面固定默认 URL `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`（确认后后台写入）。
 - `key_points` 必须**单个字符串**（多条用分号/编号拼接，非数组）。
 
@@ -14,4 +14,4 @@
 
 ## 自查清单（7 项）
 
-1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang="简体中文"；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。
+1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang 为 `zh/tw/en` 之一；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。

package/skills/multi/soke-ai-coach-director/scripts/activator.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# AI 陪练 — 学习提醒钩子
+# 每轮对话后提醒评估学习（可选启用）
+echo "[activator] 提醒：检查本轮是否有新的学习点需要记录"

package/skills/multi/soke-ai-coach-director/scripts/error-detector.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# AI 陪练 — 命令错误检测
+# 命令执行失败时自动检测并提示记录
+echo "[error-detector] 检测到错误，建议记录到 .learnings/ERRORS.md"

package/skills/multi/soke-ai-coach-director/scripts/extract-skill.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# AI 陪练 — 学习条目提取为独立 skill
+# 用法: extract-skill.sh LRN-YYYYMMDD-XXX [--dry-run]
+LEARNING_ID="$1"
+DRY_RUN="$2"
+echo "[extract-skill] 从 $LEARNING_ID 提取新 skill"
+[ "$DRY_RUN" = "--dry-run" ] && echo "[dry-run] 预览模式，不实际执行"

package/skills/multi/soke-ai-coach-director/scripts/gate_check.py

@@ -63,6 +63,8 @@ def check(sc: dict) -> list:
         errs.append("[闸门8] key_points 为空（检查 Part1 是否误写数组）")
     if not (sc.get("tags") and len(sc.get("tags", [])) >= 3):
         errs.append("[闸门8] tags 少于 3 个")
+    if sc.get("scene_lang") not in {"zh", "tw", "en"}:
+        errs.append(f"[闸门8] scene_lang 必须是 zh、tw 或 en，当前 {sc.get('scene_lang')!r}")
 
     # 12. 整体设定 ≤ 3000 字
     if len(os_text) > 3000:

package/skills/multi/soke-ai-coach-director/scripts/validate_operations.py

@@ -54,8 +54,8 @@ def validate_part1(data: dict) -> list[str]:
         errors.append("key_points: ❌ 被写成数组，平台会接受但字段为空。改为分号拼接的单字符串")
 
     # scene_lang
-    if data.get("scene_lang") != "简体中文":
-        errors.append(f"scene_lang: 必须固定为 '简体中文'，当前 {data.get('scene_lang')!r}")
+    if data.get("scene_lang") not in {"zh", "tw", "en"}:
+        errors.append(f"scene_lang: 必须是 zh、tw 或 en，当前 {data.get('scene_lang')!r}")
 
     # scenario_cover 或 cover_url（CLI 接受两者）
     cover = data.get("scenario_cover") or data.get("cover_url")
@@ -70,6 +70,13 @@ def validate_part1(data: dict) -> list[str]:
 def validate_part2(operations: list) -> list[str]:
     errors = []
 
+    for i, op in enumerate(operations):
+        if op.get("type") != "update_basic":
+            continue
+        data = op.get("data", {})
+        if "scene_lang" in data and data.get("scene_lang") not in {"zh", "tw", "en"}:
+            errors.append(f"operations[{i}].data.scene_lang: 必须是 zh、tw 或 en，当前 {data.get('scene_lang')!r}")
+
     # 操作 1: update_basic (OS)
     os_ops = [o for o in operations if o.get("type") == "update_basic"]
     if not os_ops:

package/skills/multi/soke-ai-training/SKILL.md

@@ -89,6 +89,8 @@ soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format
 
 ### 创建场景
 
+`scene_lang` 是场景语言代码，合法值仅有 `zh`（简体中文）、`tw`（繁体中文）和 `en`（英文）。CLI flags 与 `--request-file` 使用同一枚举校验；不要传入 `简体中文`、`中文`、`zh-CN` 或其他值。
+
 如果封面图由本地智能体生成，先上传封面并拿到可写入 `scenario_cover` 的 CDN URL：
 
 ```bash

package/skills/multi/soke-course/.skill-metadata.yaml

@@ -0,0 +1,40 @@
+examples:
+  - id: create-and-publish
+    title:
+      zh: 创建课程并发布
+    description:
+      zh: 从零创建一门线上课，走完课件、发布全流程
+    prompt:
+      zh: |-
+        帮我创建一门线上课：
+
+        课程标题：{{课程标题}}
+        课程分类：{{可选，分类名称}}
+
+        创建完成后引导我添加课件并发布。
+  - id: add-courseware
+    title:
+      zh: 给课程加课件
+    description:
+      zh: 给已有课程添加视频/音频/文档/图片/小测验课件
+    prompt:
+      zh: |-
+        给课程「{{课程名称}}」添加课件：
+
+        素材：{{本地文件路径或"从素材库选择"或"小测验/图片"}}
+  - id: publish-and-assign
+    title:
+      zh: 发布并指派学员
+    description:
+      zh: 对已有课程执行发布校验、发布，并指派给部门
+    prompt:
+      zh: |-
+        把课程「{{课程名称}}」发布，并指派给{{部门名称}}，{{必修|选修}}。
+  - id: query-progress
+    title:
+      zh: 查学习进度
+    description:
+      zh: 查询课程完成率、学员进度、作业提交情况
+    prompt:
+      zh: |-
+        看看课程「{{课程名称}}」的学习进度和完成率。

package/skills/multi/soke-course/CHANGELOG.md

@@ -0,0 +1,77 @@
+# 变更日志
+
+## v6.47.0 · 2026-09-01
+
+- 移除单独的“回复格式：课程标题 A1B3C1”和固定编码示例。
+- 改为自然语言提示用户直接提供课程标题、课件来源、分类、模板及本地文件路径。
+
+## v6.46.0 · 2026-09-01
+
+- 固定单课程首轮输出顺序，确保标题、A 来源、B 分类、分类提示、C 模板和回复示例完整出现。
+- 分类和模板统一使用“编码在名称前”的展示格式。
+- 指派与发布改为两个连续弹窗：先确认是否指派，再确认是否发布。
+- 指派弹窗固定为「1. 指派（推荐）/2. 不指派」；发布弹窗固定为「1. 发布/2. 不发布」。
+
+## v6.45.0 · 2026-09-01
+
+- 统一单课程首轮输出顺序和格式。
+- 分类、模板选项统一采用“编码在名称前”的展示方式。
+- 指派弹窗固定顺序为“1. 指派（推荐）/2. 不指派”。
+- 发布弹窗固定顺序为“1. 发布/2. 不发布”。
+
+## v6.44.0 · 2026-09-01
+
+- 修复创建课程时 B 分类列表为空或使用占位内容的问题。
+- 分类选择现在必须先拉取真实分类接口返回，再展示一级分类标题和 UUID。
+- 统一分类字段为 `data.list[].title`、`uuid`、`parent_id`，不再使用未验证的 `name`/`id` 字段。
+- 未确认的 `--parent-id`、`--level` 参数不得直接调用。
+
+## v6.43.0 · 2026-09-01
+
+- 优化未登录处理：自动执行 `soke-cli auth login` 调用网页登录授权。
+- 登录完成后自动回查「用户凭证」，失败或取消时停止后续写操作。
+- 修正环境检查脚本对中文登录字段的识别。
+
+## v6.42.0 · 2026-09-01
+
+- 优化“查看学习统计”入口：未指定课程时先展示已发布线上课前 20 个。
+- 增加按课程标题模糊搜索和分页选择提示，选定课程后再查询统计。
+
+## v6.41.0 · 2026-09-01
+
+- 优化对外分享元数据，移除残留英文示例。
+- 增加已有课程操作不再弹模式选择的使用说明。
+
+## v6.40.0 · 2026-09-01
+
+- 补齐关键 CLI 命令的最低返回字段契约。
+- 增加批量目录扫描的隐藏文件、符号链接、大小写扩展名和空目录规则。
+- 完善动作级中断恢复和批量结果记录要求。
+- 清理分享元数据中的英文示例。
+
+## v6.39.0 · 2026-09-01
+
+- 修复已有 `course-id`、目录路径与模式选择之间的路由冲突。
+- 增加创建前查重、发布确认前二次状态查询和 Gate Check。
+- 明确批量任务的单课失败隔离、超时回查、失败汇总和恢复位置。
+
+## v6.38.0 · 2026-09-01
+
+- 统一为 5 阶段流程：创建、课件、设置、指派与发布、查询与维护。
+- 统一执行顺序：课件 → 设置 → 指派 → Gate Check → 发布。
+- 模板自动应用 CLI 支持的高级设置，后台能力标记为待办。
+- 修正立即发布与定时发布的 Gate Check 和回查规则。
+- 修正图片字段白名单、分类末级选择、素材库分页和 clock 分页字段。
+- 增加写操作回查、批量失败隔离和中断恢复要求。
+- 统一示例、排障文档和 WorkBuddy 安装路径。
+
+## 兼容性说明
+
+- 命令参数以 `references/cli-facts.md` 为唯一事实源。
+- 当前事实表实测版本为 `soke-cli v1.0.77`。
+- 旧版示例中的“先发布后指派”流程不再适用。
+- 未经 `--help` 或实际回归验证的参数，不得直接写入其他 SOP。
+
+## 历史版本
+
+- v6.37.0 及更早版本的详细记录保留在版本发布包或内部备份中；对外分享包只保留当前版本和兼容性说明。

package/skills/multi/soke-course/README.md

@@ -1,291 +1,44 @@
-# 授客课程管理 Skill
+# 课程发布主管 · 安装使用教程
 
-完整的课程生命周期管理，集成素材库和课件管理子 skills，提供模块化的课程内容管理。
+授客AI平台线上课端到端管理技能（自包含单技能，v6.47.0）。
 
-## 普通用户文档
+## 前提
 
+- WorkBuddy 桌面端；
+- Node.js ≥ 14；
+- 授客AI平台账号（需有课程管理权限）。
 
-## 功能概述
+## 安装
 
-这个 skill 提供了完整的课程管理功能，包括：
+1. 在 WorkBuddy 中安装或更新 `soke-course` 技能；
+2. 手动安装时放入 `~/.workbuddy/skills/soke-course/`。
 
-- 📚 **课程管理**: 创建、更新、发布、查询课程
-- 🏷️ **分类管理**: 查询和管理课程分类
-- 📦 **素材管理**: 集成 soke-material skill，管理素材库
-- 📝 **课件管理**: 集成 soke-lesson skill，管理课程课件
-- 👥 **学习记录**: 查询用户的课程学习记录
-- 📊 **学习统计**: 查询课件学习记录和人脸识别记录
+## 首次配置（一次性）
 
-## 集成的子 Skills
+在 WorkBuddy 中说任意触发语（如"帮我创建一门线上课"），技能会自动：
+1. 检测 soke-cli → 未装则按内置 `soke-cli-install-guide.md` 引导（三步：npm prefix → PATH → `npm install -g @sokeai/cli@latest`）；
+2. 检测登录 → 未登录或凭证过期时自动执行 `soke-cli auth login`，调用网页登录授权；授权结束后自动回查登录状态，失败则停止后续写操作。
 
-### 📦 soke-material - 素材库管理
-负责文件上传和素材管理
-- [详细文档](./references/dependencies/soke-material.md)
+## 三个典型用法
 
-### 📚 soke-lesson - 课件管理
-负责课件的创建和管理
-- [详细文档](./references/dependencies/soke-lesson.md)
+- 「帮我创建一门新员工入职培训课，分类选企业管理」→ 全流程引导（分类→模板→课件→设置→指派→Gate Check→发布）；
+- 「给这门课加个视频 + 一张封面图」→ 识别为已有课程操作，直接进入课件/封面处理，不再弹出单课或批量模式选择；
+- 「看看谁学完了」→ 未指定课程时先展示已发布线上课前 20 个，支持「搜索 XX」和「下一页」；选定课程后查询学习进度/完成率/作业提交。
 
-## 快速开始
+## 能力边界（管理预期）
 
-### 创建课程
+| CLI 可做 | 需后台 |
+|---------|--------|
+| 创建/更新/关闭/发布/定时发布、五类课件、高级设置、指派、进度/人脸/作业查询 | 删除/复制课程、审批/批量发布、新建分类、收费价格/试看、证书/签名、讲师/标签/积分、文章/外链/SCORM/HTML 课件、AI做课 |
 
-```bash
-# 1. 查询课程分类，获取 category-id
-soke-cli course +list-categories
+## 给学习地图用户
 
-# 2. 创建课程（使用上一步获取的 category-id）
-soke-cli course +create --title "Go语言入门" --category-id "CATEGORY-UUID"
+本技能内嵌指派能力，但 `soke-learning-map` 技能依赖独立的 soke-assign；如同时使用学习地图，请另行安装 soke-assign。
 
-# 3. 上传素材
-soke-cli file +upload --file ./lesson1.mp4
+## 反馈
 
-# 4. 创建课件
-soke-cli course +lesson-create \
-  --course-id "COURSE-UUID" \
-  --title "第一课" \
-  --media-id "MATERIAL-UUID" \
-  --type "video" \
-  --length 600 \
-  --object "path/to/file.mp4" \
-  --filename "lesson1.mp4" \
-  --ext "mp4" \
-  --filesize 10485760
+用出问题请反馈，格式三要素：**场景 + 期望 + 实际**（例：场景"导入试卷建测验"，期望"自动建卷挂载"，实际"第3步填空题报错"）。
 
-# 5. 发布课程
-soke-cli course +publish --course-id "COURSE-UUID"
-```
+## 变更日志
 
-### 查询课程
-
-```bash
-# 查询课程列表
-soke-cli course +list-courses
-
-# 查询课程详情
-soke-cli course +get-course --course-id "COURSE-UUID"
-
-# 查询课程分类
-soke-cli course +list-categories
-
-# 查询课程学习记录
-soke-cli course +list-course-users --course-id "COURSE-UUID"
-```
-
-## 主要命令
-
-### 课程管理
-| 命令 | 说明 |
-|------|------|
-| `+list-categories` | 查询课程分类（获取 category-id） |
-| `+create` | 创建课程基本信息 |
-| `+update` | 更新课程信息 |
-| `+delete` | 删除未发布或已关闭课程 |
-| `+advanced` | 更新课程高级设置 |
-| `+publish` | 发布课程 |
-| `+get-course` | 查询课程详情 |
-| `+list-courses` | 查询课程列表 |
-
-### 课件管理（soke-lesson）
-| 命令 | 说明 |
-|------|------|
-| `+lesson-create` | 创建课件 |
-| `+lesson-get` | 查询课件详情 |
-| `+lesson-list` | 查询课件列表 |
-
-### 素材管理（soke-material）
-| 命令 | 说明 |
-|------|------|
-| `file +upload` | 上传文件到素材库 |
-| `file +list-files` | 查询素材列表 |
-| `file +get-info` | 查询素材详情 |
-
-### 学习记录
-| 命令 | 说明 |
-|------|------|
-| `+list-course-users` | 查询课程学习记录 |
-| `+get-course-user` | 查询用户学习详情 |
-| `+list-lesson-learns` | 查询课件学习记录 |
-| `+list-lesson-faces` | 查询人脸识别记录 |
-
-## 使用场景
-
-### 场景1: 创建课程
-
-适用于需要精细控制每个步骤的场景：
-
-```bash
-# 1. 查询课程分类，获取 category-id
-soke-cli course +list-categories
-
-# 2. 创建课程（使用上一步获取的 category-id）
-course_id=$(soke-cli course +create \
-  --title "Python数据分析实战" \
-  --category-id "CATEGORY-UUID" \
-  --format json | jq -r '.data.uuid')
-
-# 3. 批量上传素材
-for file in ./lessons/*.mp4; do
-  media_id=$(soke-cli file +upload --file "$file" --format json | jq -r '.data.uuid')
-  
-  # 4. 创建课件
-  soke-cli course +lesson-create \
-    --course-id "$course_id" \
-    --title "$(basename "$file" .mp4)" \
-    --media-id "$media_id" \
-    --type "video" \
-    --length 600 \
-    --object "path/to/$(basename "$file")" \
-    --filename "$(basename "$file")" \
-    --ext "mp4" \
-    --filesize $(stat -f%z "$file")
-done
-
-# 5. 发布课程
-soke-cli course +publish --course-id "$course_id"
-
-# 或定时发布课程，输入北京时间
-soke-cli course +publish \
-  --course-id "$course_id" \
-  --publish-time "2026-07-14 17:24:42"
-```
-
-### 场景2: 管理现有课程
-
-```bash
-# 查询课程列表
-soke-cli course +list-courses --status 1
-
-# 获取课程详情
-soke-cli course +get-course --course-id "COURSE-UUID"
-
-# 查询课程的课件
-soke-cli course +lesson-list --course-id "COURSE-UUID"
-
-# 更新课程信息
-soke-cli course +update \
-  --course-id "COURSE-UUID" \
-  --title "新标题" \
-  --description "新描述"
-
-# 删除未发布或已关闭课程
-soke-cli course +delete --course-id "COURSE-UUID"
-
-# 添加新课件
-media_id=$(soke-cli file +upload --file ./new-lesson.mp4 --format json | jq -r '.data.uuid')
-soke-cli course +lesson-create \
-  --course-id "COURSE-UUID" \
-  --title "新增课件" \
-  --media-id "$media_id" \
-  --type "video" \
-  --length 600 \
-  --object "path/to/new-lesson.mp4" \
-  --filename "new-lesson.mp4" \
-  --ext "mp4" \
-  --filesize 10485760
-```
-
-### 场景3: 统计课程完成情况
-
-```bash
-# 1. 获取课程列表
-soke-cli course +list-courses
-
-# 2. 查询某个课程的学习记录
-soke-cli course +list-course-users --course-id "COURSE-UUID"
-
-# 3. 查询课件学习记录
-soke-cli course +list-lesson-learns --lesson-id "LESSON-UUID"
-```
-
-## 参数说明
-
-### 时间参数
-
-所有时间参数使用 Unix 时间戳（毫秒）格式：
-
-```javascript
-// JavaScript 示例
-const startTime = new Date('2024-01-01').getTime(); // 1704038400000
-const endTime = new Date('2024-12-31').getTime();   // 1735660799000
-```
-
-### 状态参数
-
-**课程状态 (status)**:
-- `0`: 未发布
-- `1`: 已发布
-- `2`: 已关闭
-
-**课程来源 (is-in)**:
-- `0`: 外部课列表
-- `1`: 内部课列表
-
-**学习模式 (study_type)**:
-- `1`: 自由式（可任意顺序学习）
-- `2`: 解锁式（必须按顺序学习）
-
-## 注意事项
-
-1. **课程发布要求**: 课程至少需要一个课件才能发布
-2. **分类必填**: 创建课程时必须指定分类ID
-3. **素材先行**: 创建课件前必须先上传素材到素材库
-4. **类型匹配**: 课件类型必须与素材类型匹配
-5. **权限要求**: 需要相应的读写权限（`course:*:write` 或 `course:*:readonly`）
-6. **认证要求**: 所有命令都需要先完成 `soke-cli auth login`
-
-## 错误处理
-
-### 权限不足
-
-```bash
-# 错误信息: Permission denied
-# 解决方案: 检查是否已登录，并确认账号有相应权限
-soke-cli auth login
-```
-
-### 时间范围超限
-
-```bash
-# 错误信息: Time range exceeds 365 days
-# 解决方案: 缩小时间范围或分批查询
-```
-
-### 数据不存在
-
-```bash
-# 错误信息: Course not found
-# 解决方案: 检查课程ID是否正确
-```
-
-## 相关文档
-
-- [SKILL.md](./SKILL.md) - 完整的 Skill 文档和 API 参考
-- [素材库管理 Skill](./references/dependencies/soke-material.md) - 文件上传和素材管理
-- [课件管理 Skill](./references/dependencies/soke-lesson.md) - 课件创建和管理
-- [共享配置 Skill](./references/shared.md) - 认证和配置管理
-
-## Skill 架构
-
-```
-soke-course (主 skill)
-├── 课程管理 (本 skill)
-│   ├── +create (创建课程)
-│   ├── +update (更新课程)
-│   ├── +publish (发布课程)
-│   └── 查询命令...
-├── soke-lesson (子 skill - 课件管理)
-│   ├── +lesson-create
-│   ├── +lesson-get
-│   └── +lesson-list
-└── soke-material (子 skill - 素材管理)
-    ├── file +upload
-    ├── file +create
-    └── 查询命令...
-```
-
-## 版本历史
-
-- v3.0.0 (2024-05-26): 重构为模块化架构，集成 soke-material 和 soke-lesson 子 skills
-- v2.0.0 (2024-05-25): 添加课程创建和更新功能
-- v1.0.0 (2024-05-14): 初始版本，支持课程查询、分类、学习记录等功能
+详见同目录 `CHANGELOG.md`。对外分享时可只保留当前版本、兼容性说明和最近重要变更。