@sokeai/cli 1.0.66 → 1.0.67

package/README.md

@@ -166,6 +166,41 @@ soke-cli api POST /some/endpoint --data '{"key": "value"}'
 
 ## 开发指南
 
+### 环境配置
+
+项目根目录下维护两份应用配置，环境标志与文件对应关系如下：
+
+- `pro`：正式环境，读取 `app.pro.yaml`
+- `pre`：预发/测试环境，读取 `app.pre.yaml`
+
+本地调试默认读取正式环境配置：
+
+```bash
+go run main.go
+```
+
+也可以显式指定正式环境。`pro` 是项目内正式环境标志：
+
+```bash
+SOKE_ENV=pro go run main.go
+```
+
+如需本地调试预发环境，通过 `SOKE_ENV=pre` 指定：
+
+```bash
+SOKE_ENV=pre go run main.go
+```
+
+也可以直接指定配置文件路径：
+
+```bash
+SOKE_APP_CONFIG=app.pre.yaml go run main.go
+```
+
+正式发版请使用 `scripts/build-binaries.sh`。该脚本固定读取 `app.pro.yaml`，并把正式配置注入到发布二进制中，避免发布时误用预发配置。
+
+更多说明见：[环境配置说明](docs/ENVIRONMENT_CONFIG.md)。
+
 ### 从接口封装到发布的完整流程
 
 #### 1️⃣ 接口封装为 CLI 命令

package/package.json

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

package/scripts/build-binaries.sh

@@ -15,8 +15,17 @@ NC='\033[0m' # No Color
 VERSION=$(node -p "require('./package.json').version")
 echo -e "${GREEN}开始编译 soke-cli v${VERSION}${NC}"
 
+# 正式发版固定使用正式环境配置
+CONFIG_FILE="app.pro.yaml"
+if [ ! -f "${CONFIG_FILE}" ]; then
+    echo -e "${RED}错误: 配置文件不存在: ${CONFIG_FILE}${NC}"
+    exit 1
+fi
+CONFIG_BASE64=$(base64 < "${CONFIG_FILE}" | tr -d '\n')
+echo -e "${YELLOW}使用配置文件: ${CONFIG_FILE}${NC}"
+
 # 编译参数
-LDFLAGS="-s -w -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/version.Version=${VERSION}"
+LDFLAGS="-s -w -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/version.Version=${VERSION} -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/core.EmbeddedConfigBase64=${CONFIG_BASE64}"
 
 # 创建输出目录
 BIN_DIR="bin"

package/skills/README.md

@@ -36,6 +36,7 @@ npx skills add <org>/soke-cli --skill soke-exam -y -g
 # 复制到全局skills目录
 cp -r skills/soke-shared ~/.claude/skills/
 cp -r skills/soke-exam ~/.claude/skills/
+cp -r skills/soke-training-demand ~/.claude/skills/
 
 # 或复制到项目级skills目录
 mkdir -p .claude/skills
@@ -171,6 +172,7 @@ cp -r skills/soke-<module> ~/.claude/skills/
 - `soke-course` - 课程管理
 - `soke-contact` - 组织架构（部门、用户、讲师）
 - `soke-training` - 培训管理
+- `soke-training-demand` - 培训需求收集
 - `soke-credit` - 学分管理
 - `soke-certificate` - 证书管理
 - 等等...

package/skills/SKILL.md

@@ -2,7 +2,7 @@
 name: soke-cli
 summary: 授客AI CLI 全套 Skills 索引 — 安装指南与各业务模块能力总览
 version: 1.0.0
-description: "授客AI CLI（soke-cli）Skills 总索引：包含安装配置、认证登录，以及课程、考试、素材、课件、指派、学习地图、学习档案等全业务模块的 AI 快捷命令。当用户需要了解授客AI CLI 有哪些能力、从零开始使用、或不确定该调用哪个 skill 时使用。"
+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, 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."
 metadata:
   requires:
     bins: ["soke-cli"]
@@ -70,6 +70,21 @@ metadata:
 
 ---
 
+### soke-examPool — 可练习题库查询
+
+**路径**: [soke-examPool/SKILL.md](./soke-examPool/SKILL.md)
+
+按 `examQuestionPool` 接口链路查询可练习题库，严格遵循“题库列表 -> 题库详情 -> 题目列表”的参数依赖。
+
+**核心能力**:
+- 查询可练习题库列表，获取后续依赖的 `uuid`
+- 用同一个 `pool-id` 查询题库详情和题目列表
+- 查看题目选项、答案、解析和当前用户题库状态
+
+**关键细节**: `page`、`page-size`、`status` 只用于列表接口；详情和题目接口只传 `pool-id`。
+
+---
+
 ### soke-assign — 指派管理
 
 **路径**: [soke-assign/SKILL.md](./soke-assign/SKILL.md)
@@ -158,6 +173,19 @@ metadata:
 
 ---
 
+### soke-training-demand — 培训需求收集
+
+**路径**: [soke-training-demand/SKILL.md](./soke-training-demand/SKILL.md)
+
+查询培训需求列表和分类，提交新的培训需求，并给已有培训需求投票。
+
+**核心能力**:
+- 查询需求列表，获取投票所需的需求 `uuid`
+- 查询需求分类，获取创建所需的分类 `uuid` 和 `title`
+- 提交培训需求、给需求投票
+
+---
+
 ## Skills 依赖关系
 
 ```
@@ -166,11 +194,13 @@ soke-cli安装指南.md (所有 skill 的前置条件)
     └── soke-shared (认证/配置/权限基础)
             │
             ├── soke-exam
+            ├── soke-examPool
             ├── soke-assign
             ├── soke-learning-profile
             ├── soke-material
             ├── soke-lesson
             ├── soke-learning-map ──→ soke-assign
+            ├── soke-training-demand
             ├── soke-photo-gallery
             └── soke-course ──→ soke-material
                              ──→ soke-lesson
@@ -189,7 +219,9 @@ soke-cli安装指南.md (所有 skill 的前置条件)
 | 上传视频/音频/文档素材 | [soke-material](./soke-material/SKILL.md) |
 | 创建/管理课件 | [soke-lesson](./soke-lesson/SKILL.md) |
 | 创建/发布/查询考试、题库、试卷 | [soke-exam](./soke-exam/SKILL.md) |
+| 查询可练习题库详情和题目列表 | [soke-examPool](./soke-examPool/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-photo-gallery](./soke-photo-gallery/SKILL.md) |
+| 提交培训需求/需求投票/查询需求分类 | [soke-training-demand](./soke-training-demand/SKILL.md) |

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

@@ -0,0 +1,71 @@
+# 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
+
+---