@sokeai/cli 1.0.77 → 1.0.78

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sokeai/cli",
-    "version": "1.0.77",
+    "version": "1.0.78",
     "description": "授客AI官方CLI工具 - 支持AI Agent Skills",
     "bin": {
         "soke-cli": "scripts/run.js"

package/scripts/install.js

@@ -109,7 +109,7 @@ function detectSkillNames(packagedSkillsDir) {
 
 function syncSkillsToSokeclawWorkspace() {
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
   if (!fs.existsSync(packagedSkillsDir)) return;
 
   const targetDirs = detectSokeclawWorkspaceSkillsDirs();
@@ -228,7 +228,7 @@ function syncSkillsToWorkclawRegistry() {
   }
 
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
   if (!fs.existsSync(packagedSkillsDir)) return;
 
   let registry;

package/scripts/local-test.js

@@ -383,7 +383,7 @@ function main() {
 
   // 检测项目目录
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
 
   if (!fs.existsSync(packagedSkillsDir)) {
     logError(`Skills 目录不存在: ${packagedSkillsDir}`);

package/scripts/test-auto-detect.js

@@ -68,7 +68,7 @@ function parseSkillMetadata(skillDir) {
 
 // 测试
 const packageRoot = path.join(__dirname, '..');
-const skillsDir = path.join(packageRoot, 'skills');
+const skillsDir = path.join(packageRoot, 'skills', 'multi');
 
 console.log('🔍 测试自动检测功能\n');
 console.log('Skills 目录:', skillsDir);
@@ -102,7 +102,24 @@ for (const skillName of skillNames) {
 // 验证结果
 console.log('📊 验证结果:\n');
 
-const expectedSkills = ['soke-course', 'soke-exam', 'soke-shared'];
+const expectedSkills = [
+  'soke-ai-coach-director',
+  'soke-ai-training',
+  'soke-assign',
+  'soke-certificate',
+  'soke-course',
+  'soke-exam',
+  'soke-exam-question-pool',
+  'soke-learning-map',
+  'soke-learning-profile',
+  'soke-lesson',
+  'soke-material',
+  'soke-photo-gallery',
+  'soke-shared',
+  'soke-supervisor',
+  'soke-task',
+  'soke-training-demand'
+];
 const missingSkills = expectedSkills.filter(s => !skillNames.includes(s));
 const extraSkills = skillNames.filter(s => !expectedSkills.includes(s));
 
@@ -120,6 +137,6 @@ console.log('');
 console.log('🎉 测试完成！');
 console.log('');
 console.log('💡 提示:');
-console.log('   - 新增 skill 时，只需在 skills/ 目录下创建 soke-* 目录');
+console.log('   - 新增 skill 时，只需在 skills/multi/ 目录下创建 soke-* 目录');
 console.log('   - 确保每个 skill 都有 SKILL.md 文件，包含完整的 frontmatter');
 console.log('   - install.js 会自动检测并注册所有 skills');

package/skills/README.md

@@ -1,198 +1,49 @@
-# 授客CLI AI Agent Skills
+# soke-cli Skills
 
-本目录包含授客CLI的AI Agent技能定义，使AI Agent能够自动发现和调用授客CLI的各种功能。
+本目录提供两种可复制安装的发布布局：
 
-## 安装方法
+| 布局 | 路径 | 用途 |
+|---|---|---|
+| Mono | `skills/mono/` | 推荐；一个入口包含全部业务模块和内部资料 |
+| Multi | `skills/multi/` | 按 `soke-*` 模块独立安装 |
 
-### 前提条件
+## 安装
 
-1. 已安装授客CLI：
-```bash
-npm install -g @sokeai/cli
-```
-
-2. 已完成配置和认证：
-```bash
-soke-cli auth login
-```
-
-### 安装Skills
-
-**方式1：从GitHub安装（推荐）**
-
-```bash
-# 全局安装所有skills
-npx skills add <org>/soke-cli -y -g
-
-# 或安装特定skill
-npx skills add <org>/soke-cli --skill soke-exam -y -g
-```
-
-> 注意：需要先将本项目推送到GitHub公开仓库，然后将 `<org>` 替换为实际的GitHub组织或用户名。
-
-**方式2：本地安装（开发测试）**
-
-```bash
-# 复制到全局skills目录
-cp -r skills/soke-shared ~/.claude/skills/
-cp -r skills/soke-exam ~/.claude/skills/
-cp -r skills/soke-training-demand ~/.claude/skills/
-cp -r skills/soke-task ~/.claude/skills/
-
-# 或复制到项目级skills目录
-mkdir -p .claude/skills
-cp -r skills/soke-shared .claude/skills/
-cp -r skills/soke-exam .claude/skills/
-```
-
-### 验证安装
-
-安装完成后，AI Agent会自动加载这些skills。你可以通过以下方式验证：
-
-1. 在AI Agent对话中询问："查询考试成绩"
-2. AI Agent应该能够识别并使用 `soke-exam` skill
-3. AI Agent会自动执行 `soke-cli exam +get-exam-user` 命令
-
-## Skills列表
-
-### soke-shared
-
-**功能**: 共享基础规则，包含配置、认证、权限处理
-
-**触发条件**: 
-- 首次使用soke-cli
-- 需要配置初始化
-- 需要用户登录
-- 遇到权限错误
+Mono：
 
-**关键内容**:
-- 用户认证（`soke-cli auth login`）
-- 权限不足处理
-- 错误处理规范
-- 安全规则
-
-### soke-exam
-
-**功能**: 考试管理，查询考试、考试用户和成绩
-
-**触发条件**:
-- 查询考试成绩
-- 查看考试列表
-- 查询考试用户信息
-- 查看考试分类
-
-**支持的命令**:
-- `+list-exams`: 列出考试列表
-- `+list-exam-users`: 列出考试用户成绩列表
-- `+get-exam-user`: 获取单个考试用户详细成绩
-- `+list-categories`: 列出考试分类
-
-**使用示例**:
 ```bash
-# 查询考试成绩
-soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
-
-# 列出考试
-soke-cli exam +list-exams --start-time 1672502400000 --end-time 1704038400000
-```
-
-## 目录结构
-
-```
-skills/
-├── soke-shared/              # 共享基础skill
-│   └── SKILL.md
-├── soke-exam/                # 考试管理skill
-│   ├── SKILL.md
-│   └── references/           # 详细文档
-│       └── exam-get-exam-user.md
-└── README.md                 # 本文件
-```
-
-## Skill文件格式
-
-每个skill目录包含一个 `SKILL.md` 文件，格式如下：
-
-```markdown
----
-name: skill-name              # 技能名称
-version: 1.0.0                # 版本号
-description: "简短描述。当用户需要...时使用。"  # 触发条件（关键）
-metadata:
-  requires:
-    bins: ["soke-cli"]        # 依赖的CLI工具
-  cliHelp: "soke-cli exam --help"  # 帮助命令
----
-
-# Skill标题
-
-[Markdown格式的详细说明]
+cp -R skills/mono ~/.claude/skills/soke-cli
 ```
 
-**关键字段说明**:
-- `name`: 技能标识符，小写字母、数字、连字符
-- `version`: 语义版本号
-- `description`: **最重要**，AI用它判断何时触发此skill，必须包含"当用户需要...时使用"
-- `metadata.requires.bins`: 依赖的CLI工具列表
-
-## 开发新的Skill
-
-### 步骤1：创建目录
+Multi：
 
 ```bash
-mkdir -p skills/soke-<module>/references
+cp -R skills/multi/soke-exam ~/.claude/skills/
 ```
 
-### 步骤2：编写SKILL.md
+复制后，目标 Skill 目录必须保留其内部的 `references/`、`scripts/`、`examples/`、`assets/` 等资料；这些是对应 Skill 的内部资源，不是额外安装单元。Multi 模块不依赖其他兄弟目录。
 
-参考 `soke-exam/SKILL.md` 的格式，包含：
-1. Frontmatter（name, version, description, metadata）
-2. 核心概念说明
-3. Shortcuts列表
-4. 命令详解
-5. 权限表
-6. 常见工作流
+## 使用前提
 
-### 步骤3：编写详细文档（可选）
-
-在 `references/` 目录下为每个重要命令创建详细文档。
-
-### 步骤4：测试
+先安装并登录 CLI：
 
 ```bash
-# 本地安装测试
-cp -r skills/soke-<module> ~/.claude/skills/
-
-# 在AI Agent中测试触发条件
+npm install -g @sokeai/cli@latest
+soke-cli auth login
 ```
 
-## 后续扩展
-
-可以按相同模式创建其他业务模块的skills：
-
-- `soke-course` - 课程管理
-- `soke-contact` - 组织架构（部门、用户、讲师）
-- `soke-training` - 培训管理
-- `soke-training-demand` - 培训需求收集
-- `soke-task` - 异步任务管理
-- `soke-credit` - 学分管理
-- `soke-certificate` - 证书管理
-- 等等...
+详细认证、配置和排错说明以 [Mono 安装指南](mono/references/installation.md) 或所安装模块自身的 `references/installation.md` 为准。
 
-## 注意事项
+## 模块索引
 
-1. **Description字段至关重要**: 这是AI匹配skill的唯一依据，必须清晰描述触发场景
-2. **命令示例要完整**: 包含所有必需参数，避免AI猜测
-3. **引用共享规则**: 每个业务skill都应引用soke-shared，避免重复
-4. **保持简洁**: SKILL.md应该是快速参考，详细文档放在references/目录
-5. **版本管理**: 更新skill时记得更新version字段
+Multi 中可独立安装的模块：
 
-## 相关链接
+`soke-shared`、`soke-course`、`soke-material`、`soke-lesson`、`soke-assign`、`soke-exam`、`soke-exam-question-pool`、`soke-learning-map`、`soke-learning-profile`、`soke-certificate`、`soke-photo-gallery`、`soke-training-demand`、`soke-task`、`soke-supervisor`、`soke-ai-training`、`soke-ai-coach-director`。
 
-- 授客AI开放平台: https://opendev.soke.cn
-- NPM包: @sokeai/cli
-- Skills规范: https://github.com/agent-skills/spec
+模块的触发条件、命令参数和工作流只维护在各自的 `SKILL.md` 中。需要全部能力时安装 Mono，不要同时安装 Mono 与对应 Multi 模块，以免重复加载。
 
-## 许可证
+## 维护约定
 
-MIT
+- 新增业务模块时，只在 `skills/multi/<module>/` 创建独立 Skill，再同步一份模块参考资料到 `skills/mono/references/modules/<module>/`。
+- Mono 入口只负责路由和跨模块规则；详细流程放在模块 `MODULE.md` 或专项参考文件中。
+- 独立安装所需的共享资料可以在 Multi 模块中保留副本；Mono 内部不得再创建同一资料的平行副本。

package/skills/SKILL.md

@@ -1,257 +1,35 @@
 ---
 name: soke-cli
-summary: 授客AI CLI 全套 Skills 索引 — 安装指南与各业务模块能力总览
-version: 1.0.0
-description: "授客AI CLI（soke-cli）Skills 总索引：包含安装配置、认证登录，以及课程、考试、素材、课件、指派、学习地图、异步任务、学习档案等全业务模块的 AI 快捷命令。当用户需要了解授客AI CLI 有哪些能力、从零开始使用、或不确定该调用哪个 skill 时使用。 | Soke AI CLI (soke-cli) skills master index: covers installation, configuration, authentication, and AI shortcut commands for all business modules including courses, exams, materials, lessons, assignments, learning maps, async tasks, and learning records. Use when users need to understand what capabilities Soke AI CLI offers, get started from scratch, or are unsure which skill to invoke."
+description: "授客AI CLI Skills 发布索引：说明 Mono 与 Multi 两种安装布局，并帮助用户选择对应业务模块。"
 metadata:
   requires:
     bins: ["soke-cli"]
 ---
 
-# 授客AI CLI Skills 总览
+# soke-cli Skills 发布索引
 
-## 前置条件（必读）
+本文件是仓库内的发布索引，不承担业务执行规则。实际安装时选择一个发布布局：
 
-**CRITICAL — 运行任何 skill 前，MUST 先用 Read 工具读取 [`./soke-cli安装指南.md`](./soke-cli安装指南.md)**
+- [Mono：完整单入口](./mono/README.md)
+- [Multi：按模块独立安装](./multi/README.md)
 
-安装指南包含以下内容，是所有 skills 正常运行的基础：
+## 选择方式
 
-- **安装 soke-cli**：`npm install -g @sokeai/cli@latest`
-- **登录授权**：`soke-cli auth login`（OAuth 浏览器授权流程）
-- **验证安装**：`soke-cli --version` / `soke-cli doctor` / `soke-cli config show`
-- **常见问题**：`command not found`、Token 过期、浏览器未自动打开等
+- 需要完整的课程、考试、学习地图、素材、AI 教练等能力：安装 [Mono](./mono/)。
+- 只需要某个业务能力：从 [Multi](./multi/) 选择对应的 `soke-*` 目录。
+- 已安装 Mono 时，不要再同时安装同名 Multi 模块，避免重复触发和规则冲突。
 
-未完成安装和登录，所有业务 skill 均无法正常工作。
+## 前置条件
 
----
-
-## Skills 目录
-
-### soke-shared — 共享基础
-
-**路径**: [soke-shared/SKILL.md](./soke-shared/SKILL.md)
-
-所有业务 skill 的基础依赖，包含认证、配置、权限处理和错误处理规范。各业务 skill 在执行前会引用此 skill。
-
-**核心能力**:
-- 配置初始化与登录（`soke-cli auth login`）
-- Token 管理与续期
-- 权限不足的排错指南
-- 命令结构说明（Shortcuts vs 通用 API）
-
----
-
-### soke-course — 课程管理
-
-**路径**: [soke-course/SKILL.md](./soke-course/SKILL.md)
-
-完整的课程生命周期管理，集成素材库（soke-material）、课件（soke-lesson）、指派（soke-assign）子 skills。
-
-**核心能力**:
-- 查询课程分类、创建/更新/发布课程
-- 查询学员学习记录与进度
-
-**依赖 Skills**: `soke-material`、`soke-lesson`、`soke-assign`
-
----
-
-### soke-exam — 考试管理
-
-**路径**: [soke-exam/SKILL.md](./soke-exam/SKILL.md)
-
-完整的考试生命周期管理，支持题库、试题、试卷、考试全链路创建与查询。
-
-**核心能力**:
-- 创建题库分类、题库、试题（7 种题型）
-- 创建/发布试卷、创建/发布考试
-- 指派考试给用户、查询成绩
-
-**关键细节**: 填空题答案必须用 `[[答案N]]` 嵌入 title，不传 `--answer`；发布试卷/考试时 `--title` 必传。
-
----
-
-### soke-exam-question-pool — 可练习题库查询
-
-**路径**: [soke-exam-question-pool/SKILL.md](./soke-exam-question-pool/SKILL.md)
-
-按 `examQuestionPool` 接口链路查询可练习题库，严格遵循“题库列表 -> 题库详情 -> 题目列表”的参数依赖。
-
-**核心能力**:
-- 查询可练习题库列表，获取后续依赖的 `uuid`
-- 用同一个 `pool-id` 查询题库详情和题目列表
-- 查看题目选项、答案、解析和当前用户题库状态
-
-**关键细节**: `page`、`page-size`、`status` 只用于列表接口；详情和题目接口只传 `pool-id`。
-
----
-
-### soke-task — 异步任务管理
-
-**路径**: [soke-task/SKILL.md](./soke-task/SKILL.md)
-
-独立异步任务模块，支持创建和查询导出任务。目前用于学习地图和课程学员统计导出。
-
-**核心能力**:
-- 创建异步导出任务（`soke-cli task +create`）
-- 使用 `--target-id` 统一传入学习地图或课程 UUID，通过 `--module learningMapUser|courseUser` 区分任务类型
-- 支持按部门 ID（`--departments`）和用户 ID（`--users`）筛选导出范围
-- 支持选择部门导出类型：单列导出 `aloneDept`（默认）或部门多列导出 `manyDept`
-- 查询任务状态与导出文件地址（`soke-cli task +get`）
-
----
-
-### soke-assign — 指派管理
-
-**路径**: [soke-assign/SKILL.md](./soke-assign/SKILL.md)
-
-通用学习资源指派系统，支持课程、考试、学习地图等资源指派给部门或用户。
-
-**核心能力**:
-- 查询可用部门列表（`+list-departments`）
-- 查询可用用户列表（`+list-users`）
-- 创建指派（`+create`），支持必修/选修
-- 查询指派记录（`+list`）
-
-**支持模块**: `course`、`exam`、`learning_map`
-
----
-
-### soke-learning-map — 学习地图管理
-
-**路径**: [soke-learning-map/SKILL.md](./soke-learning-map/SKILL.md)
-
-完整的学习地图生命周期管理，集成 soke-assign 子 skill。
-
-**核心能力**:
-- 查询地图分类、创建学习地图
-- 搜索课程、检查课程可用性（`+check-item-status`）
-- 创建学习阶段（自动获取课程详情，无需手动构造 JSON）
-- 发布/下架学习地图、指派学员、查询学习进度
-
-**依赖 Skills**: `soke-assign`
-
----
-
-### soke-learning-profile — 学员学习档案
-
-**路径**: [soke-learning-profile/SKILL.md](./soke-learning-profile/SKILL.md)
-
-查询学员完整学习记录，涵盖课程、考试、证书、学分积分、培训班等多维度数据。
-
-**核心能力**:
-- 按部门或学员 ID 查询学习档案（`+list`）
-- 配合 `contact +search-user` 按姓名查找学员后查档案
-
-**注意**: 档案接口不支持按姓名直接查询，需先通过 contact 模块获取 `dept_user_id`。
-
----
-
-### soke-certificate — 证书管理
-
-**路径**: [soke-certificate/SKILL.md](./soke-certificate/SKILL.md)
-
-证书管理查询，支持查询证书列表、证书分类和证书获得人员。
-
-**核心能力**:
-- 查询证书列表（`certificate +list`，对接 `/skills/certificate/list`）
-- 按状态筛选已发布/未发布/关闭/删除证书
-- 查询证书分类和证书获得人员
-
----
-
-### soke-material — 素材库管理
-
-**路径**: [soke-material/SKILL.md](./soke-material/SKILL.md)
-
-素材库文件管理，支持视频、音频、图片、文档等多种类型的上传与查询。
-
-**核心能力**:
-- 一键上传文件到 OSS 并创建素材记录（`file +upload`，自动检测类型和默认时长）
-- 查询素材列表/详情/下载链接
-- 管理素材分类
-
-**关键输出**: 上传响应包含创建课件所需的全部字段（uuid/filename/filesize/object/ext/type）。
-
----
-
-### soke-lesson — 课件管理
-
-**路径**: [soke-lesson/SKILL.md](./soke-lesson/SKILL.md)
-
-课件生命周期管理，基于素材库文件创建课件并关联到课程。
-
-**核心能力**:
-- 创建课件（`course +lesson-create`），参数全部从素材上传响应提取
-- 查询课件列表（`course +lesson-list`）和详情（`course +lesson-get`）
-
-**关键原则**: 课件参数全部来自 `file +upload` 响应，不需要手动构造。
-
----
-
-### soke-photo-gallery — 图片库管理
-
-**路径**: [soke-photo-gallery/SKILL.md](./soke-photo-gallery/SKILL.md)
-
-图片库文件管理，支持上传本地图片到 OSS 并注册到图片库、查询分类与图片列表、批量删除。
-
-**核心能力**:
-- 一键上传图片到图片库（`photo-gallery +create`，自动完成 OSS 上传 + 图片库注册）
-- 查询图片分类列表（`+list-categories`）和图片库列表（`+list`）
-- 批量删除图片（`+batch-delete`）
-
----
-
-### soke-training-demand — 培训需求收集
-
-**路径**: [soke-training-demand/SKILL.md](./soke-training-demand/SKILL.md)
-
-查询培训需求列表和分类，提交新的培训需求，并给已有培训需求投票。
-
-**核心能力**:
-- 查询需求列表，获取投票所需的需求 `uuid`
-- 查询需求分类，获取创建所需的分类 `uuid` 和 `title`
-- 提交培训需求、给需求投票
-
----
-
-## Skills 依赖关系
+所有模块都依赖已安装并完成认证的 `soke-cli`：
 
-```
-soke-cli安装指南.md (所有 skill 的前置条件)
-    │
-    └── soke-shared (认证/配置/权限基础)
-            │
-            ├── soke-exam
-            ├── soke-exam-question-pool
-            ├── soke-assign
-            ├── soke-learning-profile
-            ├── soke-certificate
-            ├── soke-material
-            ├── soke-lesson
-            ├── soke-learning-map ──→ soke-assign
-            ├── soke-training-demand
-            ├── soke-photo-gallery
-            └── soke-course ──→ soke-material
-                             ──→ soke-lesson
-                             ──→ soke-assign
+```bash
+npm install -g @sokeai/cli@latest
+soke-cli auth login
 ```
 
----
+安装、配置和权限问题请读取所安装包中的 `references/installation.md`；业务命令和工作流请读取对应 Skill 的 `SKILL.md`。
 
-## 快速选择指南
+## 维护边界
 
-| 用户意图 | 使用 Skill |
-|----------|-----------|
-| 安装 soke-cli / 登录授权 | [soke-cli安装指南.md](./soke-cli安装指南.md) |
-| 配置、权限、Token 问题 | [soke-shared](./soke-shared/SKILL.md) |
-| 创建/发布/查询课程 | [soke-course](./soke-course/SKILL.md) |
-| 上传视频/音频/文档素材 | [soke-material](./soke-material/SKILL.md) |
-| 创建/管理课件 | [soke-lesson](./soke-lesson/SKILL.md) |
-| 创建/发布/查询考试、题库、试卷 | [soke-exam](./soke-exam/SKILL.md) |
-| 查询可练习题库详情和题目列表 | [soke-exam-question-pool](./soke-exam-question-pool/SKILL.md) |
-| 将课程/考试/地图指派给部门或用户 | [soke-assign](./soke-assign/SKILL.md) |
-| 创建/发布/查询学习地图 | [soke-learning-map](./soke-learning-map/SKILL.md) |
-| 查询学员学习档案/统计数据 | [soke-learning-profile](./soke-learning-profile/SKILL.md) |
-| 查询证书列表/证书分类/证书获得人员 | [soke-certificate](./soke-certificate/SKILL.md) |
-| 上传/查询/删除图片库图片 | [soke-photo-gallery](./soke-photo-gallery/SKILL.md) |
-| 提交培训需求/需求投票/查询需求分类 | [soke-training-demand](./soke-training-demand/SKILL.md) |
+Mono 的路由与跨模块规则维护在 [mono/SKILL.md](./mono/SKILL.md)。Multi 的详细规则维护在各模块目录中。相同的共享参考文件在 Multi 中允许保留副本，以保证每个模块可以脱离仓库独立安装；Mono 内部不保留额外的平行副本。

package/skills/mono/README.md

@@ -0,0 +1,10 @@
+# soke-cli Mono Skill
+
+这是可独立安装的单入口 Skill 包。
+
+```bash
+cp -r skills/mono ~/.claude/skills/soke-cli
+```
+
+复制后不需要保留原项目目录；所有运行规则和参考资料都在本目录中。
+