@sokeai/cli 1.0.79 → 1.0.81

package/skills/mono/references/modules/soke-ai-coach-director/platform/adapters/{wukong.md → qwen.md}

@@ -1,10 +1,10 @@
-# 悟空 (Wukong) 平台适配器
+# 千问 (Qwen) 平台适配器
 
-> 悟空是阿里钉钉的企业级 AI Agent 平台，通过钉钉 IM 进行自然语言对话交互。不支持 `AskUserQuestion` 或 `render_ui`。
+> 千问是阿里钉钉的企业级 AI Agent 平台，通过钉钉 IM 进行自然语言对话交互。不支持 `AskUserQuestion` 或 `render_ui`。
 
 ## 运行环境检测
 
-- 对话上下文包含钉钉/悟空平台特征
+- 对话上下文包含钉钉/千问平台特征
 - 无 `AskUserQuestion` 工具可用
 - 交互方式为自然语言对话
 
@@ -14,11 +14,11 @@
 
 在对话中以 Markdown 纯文本完整展示 Part 内容。使用 `## 🔨 PartN：{标题}` 格式开头，逐字段输出全部正文。
 
-悟空平台支持 Markdown 渲染（标题、列表、加粗），按标准 Markdown 输出即可。
+千问平台支持 Markdown 渲染（标题、列表、加粗），按标准 Markdown 输出即可。
 
 ### 选项确认
 
-使用结构化文本编号确认（悟空不支持弹窗按钮）：
+使用结构化文本编号确认（千问不支持弹窗按钮）：
 
 ```
 请选择：
@@ -38,33 +38,33 @@
 
 ### CLI 执行
 
-悟空内置 Python 3.12 + Node.js + Bun + Chromium，通过 Tauri + Rust 架构执行系统命令。
+千问内置 Python 3.12 + Node.js + Bun + Chromium，通过 Tauri + Rust 架构执行系统命令。
 
-soke-cli 在悟空中的执行方式：
-- 悟空有企业级安全沙箱（不同于 WorkBuddy 的沙箱）
+soke-cli 在千问中的执行方式：
+- 千问有企业级安全沙箱（不同于 WorkBuddy 的沙箱）
 - soke-cli 是 npm 全局安装的 Go 编译二进制，可直接调用
-- 若悟空中 `soke-cli` 命令受限，降级为 REST API 直接调用（参考 `../api-fallback.md`）
+- 若千问中 `soke-cli` 命令受限，降级为 REST API 直接调用（参考 `../api-fallback.md`）
 
 ```bash
-# 悟空中执行 soke-cli 命令（无需 dangerouslyDisableSandbox）
-soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty
+# 千问中执行 soke-cli 命令（无需 dangerouslyDisableSandbox）
+soke-cli ai-training +create-scenario --request-file ./step1-create.json > /tmp/step1-create.json 2>/dev/null
 ```
 
-### 悟空 Skill 市场打包说明
+### 千问 Skill 市场打包说明
 
-悟空有自己的 AI 能力市场（Skill 市场），使用独立的 Skill 格式。
+千问有自己的 AI 能力市场（Skill 市场），使用独立的 Skill 格式。
 
-要将本技能发布到悟空 Skill 市场：
-1. 将 SKILL.md 转换为悟空 Skill 格式（需查阅悟空 Skill 开发文档）
+要将本技能发布到千问 Skill 市场：
+1. 将 SKILL.md 转换为千问 Skill 格式（需查阅千问 Skill 开发文档）
 2. 交互逻辑使用本适配器的纯文本模式
 3. CLI 执行层保持 soke-cli 原生调用
-4. 如有 MCP 协议需求，悟空内置 MCP 支持
+4. 如有 MCP 协议需求，千问内置 MCP 支持
 
 ## 适配器路由
 
-当检测到以下特征时，启用悟空适配器：
+当检测到以下特征时，启用千问适配器：
 - 对话环境无 `AskUserQuestion` / `render_ui` 工具
 - 平台支持 Markdown 渲染
 - 可执行系统 CLI 命令
 
-> 若 soke-cli 在悟空中完全不可用（如企业安全策略禁止），整条管线降级为：纯文本展示 Part 内容 → 用户确认 → 生成 JSON → 通过 REST API (api-fallback.md) 直接调用 MentorAI API 完成同步。
+> 若 soke-cli 在千问中完全不可用（如企业安全策略禁止），整条管线降级为：纯文本展示 Part 内容 → 用户确认 → 生成 JSON → 通过 REST API (api-fallback.md) 直接调用 MentorAI API 完成同步。

package/skills/mono/references/modules/soke-ai-coach-director/platform/adapters/workbuddy.md

@@ -36,7 +36,7 @@ WebChat 环境额外支持 `render_ui` QuestionForm jsonl。
 
 ```bash
 # 示例
-soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty
+soke-cli ai-training +create-scenario --request-file ./step1-create.json > /tmp/step1-create.json 2>/dev/null
 ```
 
 ## 适配器路由

package/skills/mono/references/modules/soke-ai-coach-director/platform/api-fallback.md

@@ -51,7 +51,7 @@ Body: step1-create.json 内容
 
 ### 场景查询
 
-**CLI**: `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`
+**CLI**: `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`
 
 **API**:
 ```

package/skills/mono/references/modules/soke-ai-coach-director/platform/interaction.md

@@ -1,6 +1,6 @@
 # 弹窗交互规则
 
-定义 Part1-Part5 及发布/知识包/微调的确认契约（标题/问题/选项/分支路由）。跨平台：WorkBuddy 用 AskUserQuestion，WebChat 用 render_ui QuestionForm，纯文本平台降级为编号选项（见 `platform/adapters/`）。
+定义 Part1-Part5 及发布/知识包/微调的确认契约（标题/问题/选项/分支路由）。跨平台：WorkBuddy 用 AskUserQuestion，WebChat 用 render_ui QuestionForm，纯文本平台降级为编号选项（见 `platform/adapters/`）。QClaw 适配器为可选兼容层；未部署 QClaw 时不影响其他平台或通用降级路径。
 
 ## 核心规则
 

package/skills/mono/references/modules/soke-ai-coach-director/platform/platform-support-matrix.md

@@ -0,0 +1,28 @@
+# 多平台支持矩阵
+
+> 本文件是 AI 陪练平台适配器支持状态的唯一事实源。适配器只负责环境检测、内容展示、选项确认和 CLI 执行，不承载 Part1-Part5 业务规则。
+
+| 平台 | 适配器文件 | 状态 | 交互方式 | CLI 执行 | 备注 |
+|---|---|---|---|---|---|
+| WorkBuddy | `adapters/workbuddy.md` | 稳定 | AskUserQuestion / render_ui | Bash 沙箱 | 默认平台 |
+| 千问（Qwen） | `adapters/qwen.md` | 可选 | Markdown + 编号确认 | 平台 CLI / API 降级 | 原悟空适配器已迁移为千问适配器 |
+| Zework | `adapters/zework.md` | 待验证 | 纯文本 + 编号确认 | 内部 CLI / API 降级 | 私有平台适配 |
+| QClaw | `adapters/qclaw.md` | 可选 | Markdown + 编号确认 | OpenClaw Bash | 未部署时不影响主流程 |
+| 通用降级 | `adapters/README.md` | 必须保留 | 纯文本 + 编号确认 | REST API fallback | 平台无法识别时使用 |
+
+## 支持状态定义
+
+- **稳定**：有明确运行环境和交互契约，作为默认交付路径。
+- **可选**：仅在交付目标包含该平台时加载，不是核心流程依赖。
+- **待验证**：保留适配器，但需要真实平台验收后再升级状态。
+- **已弃用**：不再接受新交付；完成迁移后删除文件和索引项。
+
+## 适配器删除规则
+
+删除平台适配器时，必须同时更新：
+
+1. 本矩阵中的平台行；
+2. `adapters/README.md` 的路由和文件索引；
+3. `platform/interaction.md` 中的平台说明；
+4. `CHANGELOG.md` 的迁移记录；
+5. 运行包检查，确保矩阵、索引和实际文件一致。

package/skills/mono/references/modules/soke-ai-coach-director/platform/soke-ai-training/soke-ai-training.md

@@ -11,12 +11,14 @@ metadata:
 
 # AI教练知识包
 
-**CRITICAL — 开始前 MUST 先读取 [`../../../soke-shared/MODULE.md`](../../../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+## 共用前置
+
+开始前读取 `../../../../../shared/README.md`，并按需加载环境检测、登录验证、对象上下文、输出、写后验证、异步任务和错误处理规则。本子模块只保留知识包同步特例。
 
 ## 使用前提
 
-1. 运行 `soke-cli auth login` 完成用户授权。
-2. 确认 `soke-cli config show` 中有 `APIBaseURL`、`AppKey`、`AppSecret`、`CorpID` 和用户 token。
+1. 按共享登录验证规则确认授权有效，不在本子模块重复维护认证流程。
+2. 不要在对话或仓库中回显 `AppSecret`、用户 token 等敏感配置；租户和对象标识必须使用 CLI 查询结果。
 3. 客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
 
 ## 推荐同步

package/skills/mono/references/modules/soke-ai-coach-director/platform/sync-engine.md

@@ -1,6 +1,6 @@
 # 平台同步引擎（字段参考手册）
 
-> ⚠️ **本文件已降级为字段参考手册**。执行规则、JSON 模板、字段硬规则、断言均以 `../references/exec-handbook.md` 为唯一事实源。本文件只保留 exec-handbook 未覆盖的：文件产出命名、一致性扫描、跨 Part 交接。
+> ⚠️ **本文件已降级为字段参考手册**。执行规则、JSON 模板、字段硬规则、断言均以 `../references/exec-common.md` 与对应的 `../references/exec-partN.md` 为事实源。本文件只保留执行文件未覆盖的：文件产出命名、一致性扫描、跨 Part 交接。
 
 ## 核心原则（补充 exec-handbook）
 
@@ -35,5 +35,5 @@ Part2 角色卡的「我的行为模式」（共鸣触发/关键台词/防御机
 ## 边界
 
 - `interaction.md` 负责：弹窗确认、按钮分支、回退链路。
-- `exec-handbook.md` 负责：确认后的 JSON 生成、CLI 模板、断言、状态快照更新（唯一事实源）。
+- `exec-common.md` 与对应 `exec-partN.md` 负责：确认后的 JSON 生成、CLI 模板、断言和状态快照更新；本文件不维护执行事实。
 - 本文件负责：字段参考、文件命名、一致性扫描。

package/skills/mono/references/modules/soke-ai-coach-director/references/env-check.md

@@ -1,5 +1,8 @@
 # soke-cli 环境检测
 
+> 通用环境与登录规则已抽取到 `../../../shared/environment-check.md` 和 `../../../shared/auth-check.md`。
+> 本文件保留 AI 陪练的兼容入口及额外依赖说明；新流程优先读取共享文件。
+
 独立于页面/创作管线，仅在需要调用平台接口时执行。
 
 ---

package/skills/mono/references/modules/soke-ai-coach-director/references/exec-handbook.md

@@ -12,8 +12,8 @@
 
 | # | 操作 | CLI 命令 | 产物 |
 |---|------|---------|------|
-| 1 | 创建场景 | `soke-cli ai-training +create-scenario --request-file ./part1-create.json --pretty` | `scenario_id` |
-| 2 | 回读验证 | `soke-cli ai-training +get-scenario --scenario-id <id> --pretty` | name/description/key_points/tags 一致 |
+| 1 | 创建场景 | `soke-cli ai-training +create-scenario --request-file ./part1-create.json > /tmp/part1-create.json 2>/dev/null` | `scenario_id` |
+| 2 | 回读验证 | `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null` | name/description/key_points/tags 一致 |
 
 > Part1 走**创建链路**，不是 preview/apply 更新链路。没有 operations 数组。
 

package/skills/mono/references/modules/soke-ai-coach-director/references/subs/publish/SOP.md

@@ -5,7 +5,7 @@
 ## Step 6: 平台同步验证
 
 1. 读取 `state-snapshot.json`，验证所有 Part 的 `applied` 均为 `true`
-2. 执行 `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`
+2. 执行 `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`
 3. 逐字段验证：
    - `key_points`、`description`、`name` → 与 `step1-create.json` 一致
    - `ai_roles` 非空 + `role_data.name` ≠ "角色数据异常"
@@ -63,10 +63,10 @@ soke-cli ai-training +publish-scenario \
   --scenario-id <scenario_id> \
   --version 1 \
   --version-description "CLI发布" \
-  --pretty
+  > /tmp/publish_result.json 2>/dev/null
 ```
 
-发布后验收：`+get-scenario --scenario-id <id> --pretty` 确认状态。
+发布后验收：`+get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`，由闸门脚本确认状态。
 
 > 🚦 闸门：发布成功后方可交付。
 

package/skills/mono/references/modules/soke-ai-training/MODULE.md

@@ -11,13 +11,40 @@ metadata:
 
 # AI教练知识包与场景管理
 
-**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+## 共用前置
 
-## 使用前提
+开始前读取 `../../shared/README.md`，并按需加载环境检测、登录验证、对象上下文、输出、写后验证、异步任务和错误处理规则。本模块只保留 AI 教练知识包特有规则；陪练场景的 Part1-Part5 生成、确认、发布闸门由 `soke-ai-coach-director` 负责。
 
-1. 运行 `soke-cli auth login` 完成用户授权。
-2. 确认 `soke-cli config show` 中有 `APIBaseURL`、`AppKey`、`AppSecret`、`CorpID` 和用户 token。
-3. 客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
+## 职责
+
+本模块负责 AI 教练知识包的同步与 source 管理、知识包版本与场景绑定、知识计划编译查询，以及已有场景的读取、安全更新、发布和快照恢复；不负责 AI 陪练 Part1-Part5 内容生成及确认流程。
+
+## 输入
+
+根据任务类型提供：
+
+- 知识包同步：manifest、Markdown sources、结构化 entries JSON 和幂等键；
+- 场景绑定：真实 `scenario-id` 与知识包 `version-ids`；
+- 场景更新：当前场景基准、`base_updated_at`、operations 和幂等键；
+- 发布或恢复：真实场景 ID，以及发布版本信息或快照 ID。
+
+客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
+
+## 业务流程
+
+1. 按任务读取当前知识包、source、场景或快照状态；
+2. 校验输入文件、真实对象 ID、版本关系和更新基准；
+3. 先预览场景更新或执行知识包同步，再进行应用、绑定、编译或发布；
+4. 使用查询命令或状态文件验证版本、绑定关系、计划和场景状态；
+5. 只返回已验证的业务对象与状态摘要。
+
+## 放行与完成条件
+
+- 知识包同步：manifest、sources 和 entries 校验通过，且同步状态文件记录成功版本；
+- 场景绑定：场景与版本 ID 均来自当前查询，绑定后知识计划可查询；
+- 场景更新：必须先取得最新 `updated_at`，preview 通过后才 apply；
+- 场景发布：仅在业务模块的发布闸门通过后执行，发布后状态可回读；
+- 只有目标对象、版本/绑定关系和最终状态均可验证时，才能报告完成。
 
 ## 推荐同步
 
@@ -238,7 +265,22 @@ soke-cli ai-training +restore-scenario-snapshot \
 
 新增场景命令默认输出 MentorAI `BaseResponse.data`；排查错误时加 `--raw` 保留 `success/errorCode/errorMessage/details/traceId`。
 
-## 注意
+## 业务产出与验证
+
+- 知识包任务产出知识包版本、source 清单和 `.mentorai-sync-state.json`；以同步响应、版本列表和状态文件共同验证。
+- 场景绑定任务产出场景与知识包版本的绑定关系及编译后的知识计划；以 `+get-plan` 回读验证。
+- 场景更新任务产出新的场景配置与更新时间；以 `+get-scenario` 回读目标字段验证。
+- 场景发布或恢复任务产出发布状态或恢复后的快照状态；必须回读实际场景状态，不能以命令已发出代替成功。
+
+## 失败与降级
+
+- 发生 409 乐观锁冲突时，重新读取最新场景和 `updated_at`，重新生成更新请求，不复用旧基准重试。
+- manifest、source 或 entries 校验失败时停止同步，不写入伪成功状态文件。
+- 上传、同步、绑定、编译或发布部分成功时，保留已完成对象和失败阶段，先查询真实状态再决定是否重试。
+- 认证、权限、网络和通用 CLI 错误按共享错误处理规则恢复；无法恢复时停止当前任务并报告人工处理入口。
+- 失败后禁止改用伪造 `corp_id`、`user_id`、`object_key` 或未经验证的业务 API 绕过限制。
+
+## 业务特例
 
 - 不要在 manifest 或 entries 中伪造 `corp_id`、`user_id` 或 `object_key`。
 - `object_key` 必须使用 upload-token 返回值。
@@ -248,4 +290,10 @@ soke-cli ai-training +restore-scenario-snapshot \
 - 场景更新请求体或 query 中不要伪造 `corp_id`、`company_id`、`user_id`。
 - 场景创建请求体中的 `corp_id`、`company_id`、`user_id`、`implementation_corp_id` 会由代理剥离，不要依赖它们选择租户。
 - 场景更新前必须以 `+get-scenario` 的 `updated_at` 作为 `base_updated_at`。
-- 场景发布需要 `+publish-scenario --scenario-id <id>`，默认带 `version=1` 和 `version_description=CLI发布`；不要把它当作局部更新命令。
+- 场景发布需要 `+publish-scenario --scenario-id <id>`，默认带 `version=1` 和 `version_description="CLI发布"`；不要把它当作局部更新命令。
+
+## 输出
+
+- 返回已验证的知识包、source、版本、场景、绑定关系、知识计划或快照状态摘要。
+- 仅在后续流程需要时传递真实对象 ID、版本 ID 和状态文件路径。
+- 原始响应、上传签名、Token 和客户材料遵循共享输出脱敏规则，不直接回显。

package/skills/mono/references/modules/soke-assign/MODULE.md

@@ -7,21 +7,58 @@ tags: [soke, assign, department, user, enrollment]
 
 # 指派管理
 
-## 触发描述
+## 共享前置
 
-课程创建并发布后，需要将课程指派给部门或具体学员时触发本技能。支持查询组织架构、查询用户列表、创建指派记录及查看指派列表。
+开始操作前读取：
 
-## 前置条件
+- `../../shared/environment-check.md`
+- `../../shared/auth-check.md`
+- `../../shared/command-discovery.md`
+- `../../shared/object-context.md`
+- `../../shared/interaction.md`
+- `../../shared/write-guard.md`
+- `../../shared/output-policy.md`
+
+## 职责
+
+负责查询部门和用户，并为已发布的课程、考试或学习地图创建和查询指派关系；不负责资源创建、配置或发布。
+
+## 输入
+
+- 已发布资源的真实 ID
+- 目标部门或用户的真实 ID
+- 指派资源类型、必修/选修属性和用户范围
+- 用户明确的指派或查询动作
+
+## 流程
+
+```text
+确认资源已发布 → 查询部门/用户 → 确认目标范围
+→ 展示指派摘要并获得确认 → 创建指派 → 查询指派结果
+```
 
-- 目标课程 `status = 1`（已发布），未发布的课程不可指派
-- 具有指派权限（管理员或课程负责人）
+## 业务特例
 
-## 执行流程
+- 目标课程必须 `status = 1`（已发布）。
+- 当前命令示例中的 `--module` 为 `course`；考试或学习地图指派须以当前 CLI 帮助和对应模块规则为准。
+- 批量指派建议单次不超过 500 人，超出时分批处理。
+- 取消指派不在 CLI 范围内，需通过后台操作。
+
+## 输出
+
+返回资源名称、指派类型、人数和处理状态等业务摘要；用户姓名可以展示，内部 ID 和完整响应遵循 `../../shared/output-policy.md`。
+
+**完成判定**：指派真正创建成功，当且仅当 `assign +list`（基于资源 ID 查询）能查到对应用户的指派记录，且记录中的必修/选修标记与请求一致。仅 `assign +create` 返回成功提示、但 `+list` 查不到记录时，视为未完成，不得向用户报告“指派成功”。
+
+## 前置条件
+
+- 目标资源已发布
+- 具有指派权限
 
 ### 1. 查询部门 `assign +list-departments`
 
 ```bash
-soke assign +list-departments
+soke-cli assign +list-departments
 ```
 
 返回当前租户下所有部门结构。输出格式预期为部门 ID 与名称的层级列表。
@@ -31,7 +68,7 @@ soke assign +list-departments
 ### 2. 查询用户 `assign +list-users`
 
 ```bash
-soke assign +list-users --department-id <departmentId>
+soke-cli assign +list-users --department-id <departmentId>
 ```
 
 | 参数 | 必填 | 说明 |
@@ -43,7 +80,7 @@ soke assign +list-users --department-id <departmentId>
 ### 3. 创建指派 `assign +create`
 
 ```bash
-soke assign +create \
+soke-cli assign +create \
   --module course \
   --module-id <courseId> \
   --compulsory <1|0> \
@@ -62,7 +99,7 @@ soke assign +create \
 ### 4. 查询指派 `assign +list`
 
 ```bash
-soke assign +list --module-id <courseId>
+soke-cli assign +list --module-id <courseId>
 ```
 
 | 参数 | 必填 | 说明 |
@@ -94,10 +131,12 @@ soke assign +list --module-id <courseId>
 5. 批量指派建议单次 user-ids 不超过 500 人，超出分批处理
 6. 取消指派（删除指派记录）需通过后台操作，CLI 不直接支持
 
+**失败降级**：若 `+create` 报“课程未发布/status 不符”或用户 ID 无效，立即停止并告知用户失败原因，不得假装成功；若批量中部分用户失败，报告成功与失败明细，不要整体宣称完成。
+
 ## 检查清单
 
 - [ ] 课程 status = 1（已发布确认）
 - [ ] 已通过 list-departments / list-users 确认目标用户 ID
 - [ ] compulsory 正确设定（1=必修, 0=选修）
 - [ ] user-ids 为逗号分隔的有效用户 ID 列表
-- [ ] 指派完成后通过 assign +list 验证结果
+- [ ] 指派完成后通过 assign +list 验证结果（查不到记录＝未完成）

package/skills/mono/references/modules/soke-certificate/MODULE.md

@@ -9,7 +9,53 @@ metadata:
   cliHelp: "soke-cli certificate --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理**
+## 共享前置
+
+开始前按需读取：
+
+- `../../shared/environment-check.md`
+- `../../shared/auth-check.md`
+- `../../shared/command-discovery.md`
+- `../../shared/object-context.md`
+- `../../shared/pagination.md`
+- `../../shared/interaction.md`
+- `../../shared/write-guard.md`
+- `../../shared/write-verify.md`
+- `../../shared/output-policy.md`
+- `../../shared/error-handling.md`
+
+本模块只保留证书业务规则；通用规则统一由共享层维护。
+
+## 职责
+
+负责证书模板、证书分类、证书资源、获得人员和证书生命周期查询/管理；不负责课程、考试或学习地图资源配置。
+
+## 输入
+
+- 用户明确的证书模板、列表、详情、分类或获得人员查询
+- 创建、更新、发布、关闭、删除或颁发时所需的业务字段
+- 真实证书、分类和学员 ID
+
+## 流程
+
+```text
+查询模板/分类 → 创建或查询证书 → 配置坐标
+→ 发布/关闭/颁发（按需确认） → 查询获得人员或关联关系
+```
+
+## 业务特例
+
+- 证书资源 UUID、证书分类 UUID 与证书获得记录 UUID 不可混用。
+- 发布、关闭、删除、颁发和批量操作必须遵循证书业务校验与共享写守卫。
+- 坐标配置和模板字段以本模块后续命令章节为准。
+
+**失败降级**：写操作（create/update/award/close/delete）若返回业务错误、未生成 `uuid` 或状态未达预期，立即停止并说明原因，不要假设成功；发布/关闭/删除等不可逆或状态敏感操作，务必先以 `+get` 或 `+list` 回读确认当前状态，再决定是否继续。
+
+## 输出
+
+返回证书名称、状态、分类、编号、获得人员和处理结果等业务摘要；内部 UUID 和完整响应遵循 `../../shared/output-policy.md`。
+
+**完成判定**：写操作以真实状态为准——`+create` 完成当且仅当返回新的 `uuid`；`+update --action publish` 完成当且仅当 `+get` 查到的 `status=1`；`--action close` 完成当且仅当 `status=2`；`+award` 完成当且仅当 `+users` 能查到对应获得记录；`+delete` 完成当且仅当原证书在 `+list` 中不再出现。仅 CLI 返回“成功”提示但状态未变更的，视为未完成。
 
 ## 核心概念
 

package/skills/mono/references/modules/soke-course/CHANGELOG.md

@@ -0,0 +1,93 @@
+# 变更日志
+
+## v6.50.0 · 2026-09-03
+
+- 修正创建课程模式判定：create 意图下除已明确给出 course-id/目录/单文件+标题外，第一步必须先弹原生二选一「单课程上传/多课程批量上传」，禁止默认进单课程（此前「仅无法判断才弹」与意图路由「默认进单课程」冲突，导致用户只说「创建课程」时看不到模式选择）。
+
+## v6.48.0 · 2026-09-03
+
+- 完整落地「创建课程」业务逻辑：新增交互规范（硬规则）、意图路由（Gate 0）、5 Phase 主流程、批量 B0-B7 流程。
+- 模式选择改为按上下文判定（course-id/目录/单文件），仅无法判断时弹原生二选一。
+- 统一 A-H 编码方案（课件来源/分类/模板/小测验/发布/学习类型/指派/出题方式）。
+- 明确弹窗例外清单：模式选择、批量上传确认、加小测验、出题方式、指派+发布条件、指派部门选择、发布警告用原生弹窗；已有试卷选择用 Markdown 表格展示前 20 份。
+- 明确「先上传课件 → 再问小测验 → 最后指派+发布条件弹窗」默认流程，禁止代发布。
+- 新增 subs/assign、subs/exam、subs/photo、subs/charge、subs/copy 五个子 SOP。
+- 新增 intent-cases.md（意图案例库）与 sop-publish-check.md（发布 Gate Check，6 项 + 关闭第 7 项）。
+- 分类编码统一为 B1..Bn；模板设置表列序统一为「设置项｜值｜状态」；批量固定不加小测验。
+- 修正 check_readiness.sh 路径（subs/ 扁平化）；补充 cli-facts.md 的 list-papers/get-paper。
+
+## 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 及更早版本的详细记录保留在版本发布包或内部备份中；对外分享包只保留当前版本和兼容性说明。