@sokeai/cli 1.0.73 → 1.0.75

package/skills/soke-exam-question-pool/SKILL.md

@@ -1,35 +1,37 @@
 ---
 name: soke-exam-question-pool
-summary: 授客可练习题库查询（题库列表、题库详情、题目列表），通过 soke-cli exam-question-pool 命令操作
-version: 1.0.0
-description: "授客可练习题库查询：按 examQuestionPool 接口链路先查询题库列表，再用题库 uuid 查询详情和题目列表。当用户需要查看可练习题库、题库详情、题目内容、答案和解析时使用。 | Soke question pool lookup: use the examQuestionPool API flow to list pools, get pool detail, and list questions."
+summary: 授客可练习题库（题库列表、题库详情、题目列表、题库练习交卷），通过 soke-cli exam-question-pool 命令操作
+version: 1.1.0
+description: "授客可练习题库：按 examQuestionPool 接口链路先查询题库列表，再用题库 uuid 查询详情、题目列表，可进行题库练习交卷。当用户需要查看可练习题库、题库详情、题目内容、答案和解析，或提交题库练习交卷时使用。 | Soke question pool: use the examQuestionPool API flow to list pools, get pool detail, list questions, and finish a practice session."
 metadata:
   requires:
     bins: ["soke-cli"]
   cliHelp: "soke-cli exam-question-pool --help"
 ---
 
-# 可练习题库查询 (examQuestionPool)
+# 可练习题库 (examQuestionPool)
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置、权限处理**
 
 ## 核心链路
 
-这组命令对接 `/skills/examQuestionPool/...` 接口。调用顺序必须固定：
+这组命令对接 `/skills/examQuestionPool/...` 接口。推荐调用顺序：
 
-1. `+list` 获取题库列表，从 `data.list[].uuid` 取题库 UUID。
-2. `+get --pool-id <uuid>` 查询详情，确认 `data.info.uuid` 与传入 `pool-id` 一致。
+1. `+list` 获取题库列表，从默认输出的 `uuid` 取题库 UUID。
+2. `+get --pool-id <uuid>` 查询详情，确认题库列表的 `uuid` 与传入 `pool-id` 一致。
 3. `+questions --pool-id <uuid>` 使用同一个 `pool-id` 查询题目。
+4. `+finish --pool-id <uuid> --answers '<答案JSON>'` 进行题库练习交卷。
 
-`--page`、`--page-size`、`--status` 只用于第一步列表分页和筛选，不要传给详情或题目查询。
+`--page`、`--page-size` 用于第一步题库列表分页查询。
 
 ## Shortcuts 总览
 
 | Shortcut | 说明 |
 |----------|------|
-| `+list` | 获取可练习题库列表，返回后续 `pool-id` 所需的 `uuid` |
+| `+list` | 获取可练习题库列表，返回后续 `pool-id` 所需的题库 `uuid` |
 | `+get` | 根据题库 `pool-id` 获取可练习题库详情 |
-| `+questions` | 根据同一个 `pool-id` 获取题库题目 |
+| `+questions` | 根据 `pool-id`(题库id)，即题库列表的 `uuid`，获取题库题目 |
+| `+finish` | 根据 `pool-id` 进行题库练习交卷 |
 
 ## +list
 
@@ -38,25 +40,23 @@ metadata:
 ```bash
 soke-cli exam-question-pool +list \
   --page 1 \
-  --page-size 10 \
-  --status 1 \
-  --format json
+  --page-size 10
 ```
 
 | 参数 | 必需 | 说明 |
 |------|------|------|
 | `--page` | 否 | 页码，从 1 开始，默认 1 |
 | `--page-size` | 否 | 每页条数，默认 10 |
-| `--status` | 否 | 状态筛选，`1` 表示启用 |
 
-关键返回字段：
+默认输出为横向单行文本，每条题库数据显示：
 
 | 字段 | 说明 |
 |------|------|
-| `data.list[].uuid` | 题库 UUID，后续作为 `--pool-id` |
-| `data.list[].title` | 题库标题 |
-| `data.list[].question_count` | 题目数量 |
-| `data.list[].category_title` | 分类名称 |
+| `uuid` | 题库 UUID，后续作为 `--pool-id` |
+| `title` | 题库标题 |
+| `description` | 题库描述，默认会清理简单 HTML 标签和换行 |
+| `题目数量` | 来自 `question_count` |
+| `创建时间` | 来自 `create_exercise_time` |
 
 ## +get
 
@@ -64,25 +64,24 @@ soke-cli exam-question-pool +list \
 
 ```bash
 soke-cli exam-question-pool +get \
-  --pool-id "<上一步 data.list[].uuid>" \
-  --format json
+  --pool-id "<上一步题库列表的 uuid，即题库id>"
 ```
 
 | 参数 | 必需 | 说明 |
 |------|------|------|
-| `--pool-id` | 是 | 题库 ID，必须来自 `+list` 的 `data.list[].uuid` |
+| `--pool-id` | 是 | 题库 ID，必须来自 `+list` 默认输出中的 `uuid` |
 
-关键返回字段：
+默认输出为横向单行文本，题库详情数据：
 
 | 字段 | 说明 |
 |------|------|
-| `data.info.uuid` | 题库 UUID，应与请求 `--pool-id` 一致 |
-| `data.info.title` | 题库标题 |
-| `data.all_count` | 题库总题数 |
-| `data.point` | 积分配置 |
-| `data.examPoolUser` | 当前用户在题库中的状态 |
-| `data.question_url` | 题库题目 JSON 地址 |
-| `data.answer_url` | 题库答案 JSON 地址 |
+| `uuid` | 题库 UUID，应与请求 `--pool-id` 一致 |
+| `title` | 题库标题 |
+| `description` | 题库描述，默认会清理简单 HTML 标签和换行 |
+| `题目数量` | 来自 `question_count` |
+| `创建时间` | 来自 `create_exercise_time` |
+| `总题数` | 来自 `data.all_count` |
+
 
 ## +questions
 
@@ -90,35 +89,67 @@ soke-cli exam-question-pool +get \
 
 ```bash
 soke-cli exam-question-pool +questions \
-  --pool-id "<同一个题库 uuid>" \
-  --format json
+  --pool-id "<题库列表的 uuid，即题库id>"
 ```
 
 | 参数 | 必需 | 说明 |
 |------|------|------|
 | `--pool-id` | 是 | 题库 ID，复用列表或详情中的同一个 UUID |
 
-关键返回字段：
+默认输出为 JSON，是题目数据本身。
+
+关键字段：
 
 | 字段 | 说明 |
 |------|------|
-| `data.pool_id` | 题库 ID，应与请求 `--pool-id` 一致 |
-| `data.content[].uuid` | 题目 UUID |
-| `data.content[].title` | 题目标题 |
-| `data.content[].type` | 题目类型 |
-| `data.content[].choices` | 选项列表 |
-| `data.content[].show_answer` | 展示答案 |
-| `data.content[].analysis` | 题目解析 |
+| `uuid` | 题目 UUID |
+| `title` | 题目标题 |
+| `type` | 题目类型 |
+| `choices` | 选项列表 |
+| `show_answer` | 展示答案 |
+| `analysis` | 题目解析 |
 
 ## 推荐操作顺序
 
 ```bash
-# 1. 查询题库列表，取 data.list[0].uuid
-soke-cli exam-question-pool +list --page 1 --page-size 10 --status 1 --format json
+# 1. 查询题库列表，取输出中的 uuid
+soke-cli exam-question-pool +list --page 1 --page-size 10
 
 # 2. 查询题库详情
-soke-cli exam-question-pool +get --pool-id "<pool_uuid>" --format json
+soke-cli exam-question-pool +get --pool-id "<pool_uuid>"
+
+# 3. 查询同一题库的题目列表
+soke-cli exam-question-pool +questions --pool-id "<pool_uuid>"
 
-# 3. 查询同一题库的题目
-soke-cli exam-question-pool +questions --pool-id "<pool_uuid>" --format json
+# 4. 题库练习交卷
+soke-cli exam-question-pool +finish \
+  --pool-id "<pool_uuid>" \
+  --answers '{"<question_uuid>":[0,1]}'
 ```
+
+## +finish
+
+提交可练习题库练习交卷。
+
+```bash
+soke-cli exam-question-pool +finish \
+  --pool-id "70DE9AFB-1C18-4F5C-B158-E25182ECBE1A" \
+  --answers '{"A93647C7-7ECF-44D6-931D-DE84344DA580":["1","1","1"],"0E7E8283-EB5F-489C-9778-34A9B2F13BA7":[0]}'
+```
+
+| 参数 | 必需 | 说明 |
+|------|------|------|
+| `--pool-id` | 是 | 题库 ID，复用列表或详情中的同一个 UUID |
+| `--answers` | 是 | 答案 JSON 原文，key 为题目 ID，数组为答题选项 |
+
+`--answers` 会加密之后进行传输。
+
+返回结果默认展示：
+
+| 字段 | 说明 |
+|------|------|
+| `rightCount` | 答对题目数 |
+| `allCount` | 全部题目数量 |
+| `rate` | 题库练习进度 |
+
+默认输出示例：`题库id:70DE9AFB-1C18-4F5C-B158-E25182ECBE1A，答对题目数：2，全部题目数量：0，题库练习进度：0%`。使用 `--format json` 时输出接口原始字段。

package/skills/soke-learning-map/soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md

@@ -121,7 +121,7 @@ soke-cli --version
 # 预期输出: soke-cli version x.x.x
 ```
 
-如果显示版本号，说明安装成功 ✅。
+如果显示版本号，说明基础安装成功。完成后续登录授权后，请继续运行 `soke-cli doctor` 做完整健康检查，确保配置、登录态、日志目录和网络连通性都可用。
 
 **如果 `which soke-cli` 无输出**，说明 PATH 未生效：
 - macOS/Linux: 确认 `echo $PATH | tr ':' '\n' | grep npm-global` 有输出，若没有请重新执行第二步
@@ -212,9 +212,47 @@ soke-cli auth logout
 
 ## 验证安装
 
-完成登录授权后，让我们验证一切是否正常工作。
+完成登录授权后，让我们验证一切是否正常工作。推荐先运行 `doctor`，它会一次性检查 CLI 版本、配置文件、登录态、日志目录和网络连通性。
 
-### 1. 查看配置信息
+### 1. 运行健康检查
+
+```bash
+soke-cli doctor
+```
+
+正常情况下会看到类似输出：
+```text
+pass    cli_version     x.x.x
+pass    config          /Users/你的用户名/.soke-cli/config.json
+pass    auth            login data looks valid locally
+pass    logs            /Users/你的用户名/.soke-cli/logs
+pass    network         https://opendev.soke.cn reachable (123ms)
+```
+
+如果任意检查项显示 `fail`，请根据同一行或下一行的 `hint` 提示处理。常见情况：
+- `config` 或 `auth` 失败：重新执行 `soke-cli auth login`
+- `logs` 失败：检查 `~/.soke-cli` 或 `SOKE_CLI_LOG_DIR` 的写入权限
+- `network` 失败：检查网络连接或代理设置
+
+需要机器可读输出时，可以使用 JSON 格式：
+
+```bash
+soke-cli doctor --format json
+```
+
+如果当前环境不能访问外网，只想检查本地安装、配置、登录态和日志目录，可以跳过网络检查：
+
+```bash
+soke-cli doctor --offline
+```
+
+网络较慢时可以调大超时时间：
+
+```bash
+soke-cli doctor --timeout 30
+```
+
+### 2. 查看配置信息
 
 ```bash
 soke-cli config show
@@ -232,9 +270,9 @@ soke-cli config show
   token过期时间: 2026-10-17 12:00:00
 ```
 
-> 💡 **说明**: `app_key` 和 `app_secret` 在当前版本中不需要手动配置，授权流程会自动处理所有必要的认证信息。
+> 💡 **说明**: `app_key` 和 `app_secret` 在当前版本中不需要手动配置，授权流程会自动处理所有必要的认证信息。如果 `doctor` 已全部通过，这一步主要用于人工确认当前登录的企业和用户信息。
 
-### 2. 测试 API 调用
+### 3. 测试 API 调用
 
 尝试调用一个简单的 API：
 
@@ -244,7 +282,7 @@ soke-cli api GET /users/me
 
 如果返回你的用户信息（JSON 格式），说明一切配置正确！
 
-### 3. 使用业务命令
+### 4. 使用业务命令
 
 尝试使用一个业务快捷命令，例如查看考试列表：
 
@@ -413,4 +451,4 @@ npx skills add liuchenlong1111/soke-cli -y -g
 
 ---
 
-**祝你使用愉快！** 🎉
+**祝你使用愉快！** 🎉

package/skills/soke-task/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: soke-task
-summary: 授客学堂异步任务管理（创建任务/查询任务），支持学习地图学员统计导出
+summary: 授客学堂异步任务管理（创建任务/查询任务），支持学习地图学员统计报表和统计生成
 version: 1.0.0
-description: "授客学堂异步任务管理：通过独立 task 命令创建和查询异步导出任务。目前支持学习地图学员统计导出任务，按“创建任务 -> 获取 data.id -> 查询任务详情和 filePath”的流程使用。当用户需要导出学习地图学员统计、查询导出任务状态、获取导出文件下载地址时使用。 | Soke Academy async task management: create and query export jobs through the standalone task command. Currently supports learning map learner statistics export tasks. Use when users need to export learner statistics, check export task status, or obtain exported file URLs."
+description: "授客学堂异步任务管理：通过独立 task 命令创建和查询异步任务。目前支持学习地图学员统计报表和统计生成，按“创建任务 -> 获取 data.id -> 查询任务详情和 filePath”的流程使用。当用户需要生成学习地图学员统计报表、生成统计、查询任务状态或获取文件下载地址时使用。 | Soke Academy async task management: create and query jobs through the standalone task command. Currently supports learning map learner statistics report/statistics generation. Use when users need to generate learner statistics reports, generate statistics, check task status, or obtain file URLs."
 metadata:
   requires:
     bins: ["soke-cli"]
@@ -18,11 +18,12 @@ metadata:
 - 任务接口是独立模块，命令统一使用 `soke-cli task ...`，不要使用 `soke-cli learning-map ...` 创建或查询任务。
 - 创建任务后必须保存返回的 `data.id`，再调用 `+get` 查询任务详情。
 - 默认用 `--format json` 获取结构化输出；需要人工快速查看时可省略 format 输出表格。
-- 当前已知任务类型是学习地图学员统计导出，`--module` 默认 `learningMapUser`，`--action` 默认 `export`，`--type` 默认 `aloneDept`。
+- 当前已知任务类型是学习地图学员统计相关任务，`--module` 默认 `learningMapUser`，`--action` 默认 `export`，`--type` 默认 `aloneDept`。
+- 查询 `soke-cli task +get --id "TASK-ID"` 后，必须根据创建任务时传入的 `--action` 判断状态字段：`action=export` 看 `data.export_status`，`action=report` 看 `data.status`。
 
 ## 命令
 
-### 创建学习地图学员统计导出任务
+### 创建学习地图学员统计任务
 
 ```bash
 soke-cli task +create \
@@ -44,8 +45,10 @@ soke-cli task +create \
 | `--learn-status` | 否 | 空 | 学习状态筛选：空值表示不限，`learning` 未完成，`finished` 已完成 |
 | `--eligible-status` | 否 | 空 | 达标状态筛选，空值表示不限 |
 | `--limit` | 否 | `4500` | 任务处理上限 |
-| `--action` | 否 | `export` | 操作类型，导出任务固定为 `export` |
+| `--action` | 否 | `export` | 操作类型：`export` 生成报表，`report` 生成统计 |
 | `--type` | 否 | `aloneDept` | 部门导出类型：`aloneDept` 单列导出，`manyDept` 部门多列导出 |
+| `--is-leave` | 否 | `0` | 是否离职：`0` 否，`1` 是 |
+| `--taskId` | 否 | 空字符串 | 任务 ID，默认空字符串 |
 | `--custom-tags` | 否 | 空 | 导出的自定义字段列表，多个字段用英文逗号分隔；也可传 JSON 字符串数组 |
 
 响应关键字段：
@@ -58,18 +61,25 @@ soke-cli task +create \
 
 默认输出会打印单行任务 ID，例如 `id:13288419`。需要完整字段时使用 `--format json`。
 
-### 查询异步导出任务
+### 查询异步任务
 
 ```bash
 soke-cli task +get --id "TASK-ID" --format json
 ```
 
+状态判断规则：
+
+| 创建任务时的 `--action` | 查询完成状态字段 | 说明 |
+|-------------------------|------------------|------|
+| `export` | `data.export_status` | 生成报表时用导出状态判断是否生成文件 |
+| `report` | `data.status` | 生成统计时用任务执行状态判断是否完成 |
+
 响应关键字段：
 
 | 字段 | 说明 |
 |------|------|
-| `data.status` | 任务执行状态；接口示例中 `2` 表示执行完成 |
-| `data.export_status` | 导出状态；接口示例中 `2` 表示已生成导出文件 |
+| `data.status` | 任务执行状态；`action=report` 生成统计时用此字段判断任务状态，接口示例中 `2` 表示执行完成 |
+| `data.export_status` | 导出状态；`action=export` 生成报表时用此字段判断导出状态，接口示例中 `2` 表示已生成导出文件 |
 | `data.filePath` | 导出文件访问地址，未生成时为空 |
 | `data.filename` | 导出文件名 |
 | `data.filesize` | 导出文件大小 |
@@ -89,6 +99,16 @@ TASK_ID=$(soke-cli task +create \
 soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.filePath'
 ```
 
+按创建任务的 action 查询状态：
+
+```bash
+# action=export
+soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.export_status'
+
+# action=report
+soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.status'
+```
+
 ## API 接口映射
 
 | CLI 命令 | API 路径 | 方法 |
@@ -101,4 +121,4 @@ soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.filePath'
 - `data.filePath` 为空：任务可能还未完成，等待后重新执行 `task +get --id "TASK-ID" --format json`。
 - `未登录授权`：按 `soke-shared` 执行 `soke-cli auth login` 后重试。
 - 自定义字段没有导出：确认已通过 `--custom-tags "字段1,字段2"` 指定，字段名需与学习地图学员统计支持的自定义字段一致。
-- 任务创建失败：确认 `--map-id` 是有效学习地图 UUID，`--module learningMapUser`，`--action export`，`--type aloneDept` 或 `--type manyDept`。
+- 任务创建失败：确认 `--map-id` 是有效学习地图 UUID，`--module learningMapUser`，`--action export` 或 `--action report`，`--type aloneDept` 或 `--type manyDept`。

package/skills/ai-coach-director/.learnings/LEARNINGS.md

@@ -1,71 +0,0 @@
-# AI 陪练 - 学习日志
-
-修正、洞察、知识缺口、最佳实践。
-
-**类别**: correction | insight | knowledge_gap | best_practice
-
----
-
-## [LRN-20260720-001] correction
-
-**Logged**: 2026-07-20T09:55:00+08:00
-**Priority**: high
-**Status**: promoted
-**Area**: coaching/role, quality-gate
-
-### Summary
-Part2 background 字段在 JSON 生成阶段有时未完整复制四段深度画像——展示时有全文但 JSON 中被截断/缩略。
-
-### Details
-用户反馈：part2-operations.json 中的 background 内容有时没有完整复制角色背景中的内容。
-根因分析：prompt-engineer 的 Step 2 第 94-95 行已有 background 逐字比对闸门，但 ai-coach-director 的协议自检清单和专项约束中没有同步体现这个检查。director 调度时流程摘要里缺少此闸门的显式标注，导致执行时容易跳过。
-
-### Suggested Action
-1. ai-coach-director 协议阶段 1 自检清单新增：`☐ Part2 每个角色的 background 四段深度画像均已逐段完整展示，无缩略`
-2. 专项约束 #3 强化：添加「JSON 写入后、preview 前强制闸门」——逐字比对 background 与展示文本 + 四维完整性检查
-3. 流水线执行 Part2 行增加：`⚠️ background 逐字比对闸门（JSON vs 展示文本）` 作为 preview 前的显式步骤
-
-### Metadata
-- Source: user_feedback
-- Related Files: ai-coach-director/SKILL.md, coaching/prompt-engineer/prompt-engineer.md, platform/sync-engine.md
-- Tags: background, part2, json-generation, truncation
-- Pattern-Key: background-truncation
-- Recurrence-Count: 1
-- First-Seen: 2026-07-20
-- Last-Seen: 2026-07-20
-
-**Promoted**: ai-coach-director/SKILL.md
-
----
-
-## [LRN-20260720-002] correction
-
-**Logged**: 2026-07-20T10:26:00+08:00
-**Priority**: high
-**Status**: promoted
-**Area**: coaching/role, platform/sync
-
-### Summary
-Part2 apply 后验收规则太弱——只检查字段非空，不检查内容一致性，导致同步失败或部分字段丢失时无法发现。
-
-### Details
-用户反馈：part2-operations.json 中的内容没有同步到平台。
-根因分析：sync-engine.md 和 ai-coach-director 的 apply 后验收只做了存在性检查（非空/name不为"角色数据异常"），没有做内容一致性检查。如果平台 API 静默丢弃或截断某个字段（如 description/communication_style/background），当前验收逻辑无法发现。apply 返回 200 但实际平台数据不完整——典型的"假成功"场景。
-
-### Suggested Action
-1. sync-engine.md apply 后验证从 2 项扩展为 5 项逐字段内容对比验收
-2. ai-coach-director 专项约束 #4 从简单验收升级为逐字段验收 + 同步失败禁止进入 Part3
-3. 流水线执行 Part2 行增加 apply 后逐字段验收显式步骤
-
-### Metadata
-- Source: user_feedback
-- Related Files: ai-coach-director/SKILL.md, platform/sync-engine.md
-- Tags: part2, sync-failure, verification, silent-failure, field-loss
-- Pattern-Key: part2-sync-verification
-- Recurrence-Count: 1
-- First-Seen: 2026-07-20
-- Last-Seen: 2026-07-20
-
-**Promoted**: ai-coach-director/SKILL.md, platform/sync-engine.md
-
----