@sokeai/cli 1.0.77 → 1.0.78

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

@@ -0,0 +1,485 @@
+# 自主学习与自我进化引擎
+
+> **v2.35 标注：本文件仅微调型任务加载，创建型任务不读**（创建型只读 SKILL.md + exec-handbook + parts/ + 对应 SOP）。
+> 核心思想:每一次诊断纠错、闸门漏拦、资产选错、子技能调度失败、用户纠正,都被自动记录并推广为永久规则。
+> 本引擎是独立 self-improving-agent 思想与 AI 陪练领域的深度整合,在泛用框架之上注入了 12 个 AI 陪练专属 Area、诊断分流触发规则和陪练推广目标表。
+
+## 引擎架构
+
+```
+用户纠正 / 命令失败 / 闸门漏拦 / 新需求
+  ↓ 自动捕获
+├─ 修正/洞察/缺口/最佳实践 → .learnings/LEARNINGS.md
+├─ 命令失败/集成异常        → .learnings/ERRORS.md
+├─ 用户请求的新能力          → .learnings/FEATURE_REQUESTS.md
+  ↓ 自我反思(每次完成任务后)
+├─ 结果是否达到预期?
+├─ 哪里可以更好?
+├─ 这是反复出现的模式吗?
+  ↓ 模式检测(同类 ≥ 3 次 + 跨 ≥ 2 任务 + 30 天内)
+↓ 自动推广
+├─ 行为改进 → 本 SKILL.md(诊断标签/闸门/资产规则/调度流程)
+├─ 工具坑点 → TOOLS.md
+├─ 调度规则 → AGENTS.md
+├─ 长期记忆 → MEMORY.md
+└─ 高价值 → 提取为独立 skill
+```
+
+## 学习存储分层
+
+| 层级 | 位置 | 容量限制 | 加载策略 |
+|------|------|---------|---------|
+| **HOT** | `.learnings/` 中 Priority=critical/high 且 Status=pending 的条目 | 无限制 | 任务开始时扫描 |
+| **WARM** | `.learnings/` 中 Priority=medium 或已 resolved 的条目 | 无限制 | 按 Area 匹配时加载 |
+| **COLD** | 已 promoted / wont_fix / 90 天以上未触发的条目 | 无限 | 显式查询时加载 |
+
+### 分层规则
+
+- Pattern 触发 3 次/7 天内 → 提升 Priority 至 high
+- Pattern 30 天未触发 → 降 Priority 至 low
+- Pattern 90 天未触发 → 归档为 COLD(不改动,仅标记)
+- **绝不删除**已确认的学习条目
+
+## 学习文件初始化
+
+首次使用时,确保 `.learnings/` 目录及文件存在:
+
+```bash
+mkdir -p .learnings
+[ -f .learnings/LEARNINGS.md ] || printf "# AI 陪练 - 学习日志\n\n修正、洞察、知识缺口、最佳实践。\n\n**类别**: correction | insight | knowledge_gap | best_practice\n\n---\n" > .learnings/LEARNINGS.md
+[ -f .learnings/ERRORS.md ] || printf "# AI 陪练 - 错误日志\n\n命令失败与集成异常。\n\n---\n" > .learnings/ERRORS.md
+[ -f .learnings/FEATURE_REQUESTS.md ] || printf "# AI 陪练 - 功能请求\n\n用户请求的新能力。\n\n---\n" > .learnings/FEATURE_REQUESTS.md
+```
+
+不覆盖已有文件。**绝不记录**密钥、token、完整对话抄本或敏感环境变量。
+
+---
+
+## AI 陪练专属 Area 标签
+
+| Area | 范围 |
+|------|------|
+| `coaching/prompt` | 提示词创建、优化、微调 |
+| `coaching/role` | 角色生成、拟真度(按需画像为增强能力) |
+| `coaching/script` | 交互剧本、流程设置 |
+| `coaching/knowledge` | 知识库构建、内容提取 |
+| `coaching/scoring` | 评分标准、评分逻辑 |
+| `diagnosis` | 诊断标签(F/I/O/P/N/L/E/S/R/K/T/D)的判定与排序 |
+| `quality-gate` | 创建闸门、微调闸门 |
+| `asset` | 资产库调用、匹配规则 |
+| `platform/sync` | 平台同步、环境检测、平台创建 |
+| `delivery` | 客户交付、培训包、看板 |
+| `cfg` | 配置、路径、环境变量 |
+
+---
+
+## 学习信号检测
+
+### 自动触发记录的场景
+
+| 场景 | 写入位置 | 类别 |
+|------|---------|------|
+| 用户纠正诊断标签归属 | LEARNINGS.md | `correction` |
+| 诊断顺序导致误判(如先P后O) | LEARNINGS.md | `correction` |
+| 闸门漏拦导致交付问题 | LEARNINGS.md | `correction` |
+| 资产选错导致分析偏差 | LEARNINGS.md | `correction` |
+| 子技能输出异常 | ERRORS.md | - |
+| 平台同步环境检测失败 | ERRORS.md | - |
+| 命令返回非零/超时/权限拒绝 | ERRORS.md | - |
+| "能不能也支持XX场景" | FEATURE_REQUESTS.md | - |
+| "为什么不能XX" | FEATURE_REQUESTS.md | - |
+| 发现新的诊断模式或标签 | LEARNINGS.md | `insight` |
+| 用户传授新的陪练业务规则 | LEARNINGS.md | `knowledge_gap` |
+| 找到比现有方法更好的流程 | LEARNINGS.md | `best_practice` |
+
+### 识别人工纠正的关键词
+
+- "不对"、"不是这样"、"应该是"、"实际上"、"你搞错了"
+- "这不是X标签,是Y标签"
+- "先查X再查Y"
+- "这个资产不对,应该用XX"
+- "闸门没拦住,少检查了XX"
+- "别"、"停止"、"以后不要"
+- "我更喜欢"、"我一向都是"
+
+### 识别偏好信号的关键词(直接记录到 SKILL.md 对应节)
+
+- "我喜欢你这样" → 强化当前行为
+- "每次都帮我做X" → 写入对应流程
+- "不要做Y" → 写入对应约束
+- "我的风格是" → 写入输出格式
+
+### 识别新需求的关键词
+
+- "能不能也"、"可以支持吗"、"为什么不"、"有没有办法"、"我想"
+
+### 以下情况不记录
+
+- 一次性指令("查一下这个文件")
+- 上下文相关("在这个场景里")
+- 假设性问题("如果怎么做会怎样")
+- 用户没有反馈时的沉默推断
+
+---
+
+## 日志格式
+
+### 学习条目(LEARNINGS.md)
+
+```markdown
+## [LRN-YYYYMMDD-XXX] category
+
+**Logged**: ISO-8601 timestamp
+**Priority**: low | medium | high | critical
+**Status**: pending
+**Area**: coaching/prompt | diagnosis | quality-gate | asset | ...
+
+### Summary
+一句话描述学到了什么
+
+### Details
+完整上下文:发生了什么、错在哪、正确的是什么
+
+### Suggested Action
+具体的修复或改进措施
+
+### Metadata
+- Source: conversation | error | user_feedback | self_reflection
+- Related Files: 涉及的文件路径
+- Tags: 标签
+- See Also: LRN-xxxxxxxxx-xxx(如与已有条目关联)
+- Pattern-Key: 可选,用于跨任务模式追踪
+- Recurrence-Count: 1
+- First-Seen: YYYY-MM-DD
+- Last-Seen: YYYY-MM-DD
+
+---
+```
+
+### 错误条目(ERRORS.md)
+
+```markdown
+## [ERR-YYYYMMDD-XXX] skill_or_command
+
+**Logged**: ISO-8601 timestamp
+**Priority**: high
+**Status**: pending
+**Area**: ...
+
+### Summary
+简要描述失败原因
+
+### Error
+\`\`\`
+实际错误消息
+\`\`\`
+
+### Context
+- 执行的命令/操作
+- 输入参数
+- 环境信息(如有)
+
+### Suggested Fix
+可识别的修复方案
+
+### Metadata
+- Reproducible: yes | no | unknown
+- Related Files: 路径
+- See Also: ERR-xxxxxxxxx-xxx(如反复出现)
+
+---
+```
+
+### 功能请求(FEATURE_REQUESTS.md)
+
+```markdown
+## [FEAT-YYYYMMDD-XXX] capability_name
+
+**Logged**: ISO-8601 timestamp
+**Priority**: medium
+**Status**: pending
+**Area**: ...
+
+### Requested Capability
+用户想要什么能力
+
+### User Context
+为什么需要、解决什么问题
+
+### Complexity Estimate
+simple | medium | complex
+
+### Suggested Implementation
+可能的实现方式
+
+### Metadata
+- Frequency: first_time | recurring
+- Related Features: 关联现有功能
+
+---
+```
+
+### ID 生成规则
+
+格式:`TYPE-YYYYMMDD-XXX`
+- TYPE: `LRN`(学习)、`ERR`(错误)、`FEAT`(功能请求)
+- 日期: 当前日期
+- 序号: 三位数 `001`、`002`...
+
+示例:`LRN-20260708-001`、`ERR-20260708-001`、`FEAT-20260708-001`
+
+---
+
+## 自我反思机制
+
+每完成一个完整任务后,主动执行三问反思:
+
+### 反思模板
+
+```
+CONTEXT: [任务类型] - [场景名称]
+REFLECTION: [我注意到什么]
+LESSON: [下次应该怎么做不同]
+```
+
+### 示例
+
+```
+CONTEXT: 微调型任务 - XX保险公司电话约访
+REFLECTION: 先P后O诊断,结果O误判导致P误报。用户指正后调整顺序才找到真正问题
+LESSON: 诊断顺序硬约束:必须先O再P,跳过必错
+```
+
+### 何时反思
+
+- 完成多步骤任务后
+- 收到反馈后(正面或负面)
+- 修复错误后
+- 发现自己的输出可以更好时
+
+反思条目同样遵循推广规则:成功应用 3 次 → 提升 Priority → 满足推广条件后写入本 SKILL.md。
+
+---
+
+## 冲突解决
+
+当学习条目相互矛盾时:
+
+1. **最具体的优先**:项目级 > Area级 > 全局
+2. **最新的优先**(同级时):尊重演化
+3. **模糊不清时** → 追问用户确认
+
+**示例**:
+- 全局规则:"微调时必须跑全部资产库"
+- 项目级规则:"药店场景微调时跳过客户角色模板库(因为药店角色已定型)"
+- → 执行时采用项目级规则
+
+---
+
+## 条目生命周期
+
+### 状态流转
+
+```
+pending → resolved | promoted | promoted_to_skill | wont_fix
+```
+
+### 解决后
+
+1. 改 `**Status**: pending` → `**Status**: resolved`
+2. 追加 Resolution 块:
+
+```markdown
+### Resolution
+- **Resolved**: ISO-8601
+- **Notes**: 简述做了什么
+```
+
+### 推广后
+
+1. 改 `**Status**: pending` → `**Status**: promoted`
+2. 加 `**Promoted**: SKILL.md | AGENTS.md | TOOLS.md | MEMORY.md`
+
+---
+
+## 模式检测与自动推广
+
+### 写入前先查重
+
+```bash
+grep -rn "关键词" .learnings/
+```
+
+- 已有类似条目 → 加 `See Also` 链接,bump 优先级,递增 `Recurrence-Count`
+- 没有 → 新建
+
+### 自动推广条件(满足全部 3 条)
+
+- `Recurrence-Count ≥ 3`
+- 跨至少 2 个不同任务
+- 30 天内出现
+
+### 推广目标
+
+| 学习类型 | 推广到 | 示例 |
+|---------|--------|------|
+| 诊断标签判定修正 | 本 SKILL.md「微调诊断标签」节 | "模板化万能回应归N不归O" |
+| 闸门漏拦 | 本 SKILL.md「质量闸门」节 | "新增第11项:每阶段退出条件" |
+| 资产选错规则 | 本 SKILL.md「资产调用规则」节 | "评分不准时同步查Bad Case库" |
+| 调度顺序优化 | AGENTS.md | "微调前必须先查err-detected" |
+| 工具/命令坑点 | TOOLS.md | "soke-cli login 需要先 node>=14" |
+| 行为模式改进 | SOUL.md | "诊断报告不含未经标签的猜测" |
+| 业务经验 | MEMORY.md | "XX客户偏好电话约访场景" |
+| 高复发价值 | 提取为独立 skill | LRN → skills/coaching-fix-name/ |
+
+### 推广时保持简洁
+
+推广到系统文件时,只写短规则,不写长篇事件描述:
+
+```
+❌ 坏:"2026年7月8日,在处理XX保险公司的陪练微调时,用户指出...经过排查发现..."
+✅ 好:"诊断顺序硬约束:必须先O再P再N,禁止跳过。"
+```
+
+---
+
+## 常见陷阱与应对
+
+| 陷阱 | 为什么危险 | 正确做法 |
+|------|-----------|---------|
+| **从沉默中学习** | 创造虚假规则 | 等待显式纠正或重复证据 |
+| **推广太快** | 污染 HOT 记忆 | 新教训保持 tentative,等待重复 |
+| **把一次性指令当规则** | 过度泛化 | 只有重复 ≥ 3 次且跨任务的才推广 |
+| **压缩时删除** | 丢失信任和历史 | 合并、汇总、或降级,不删除 |
+| **把技术问题当提示词问题** | 无效修改、故障不修复 | 严格走技术分流流程 |
+| **先P后O诊断** | 角色OOC导致P误判 | 强制 T→O→P→N 顺序 |
+| **忽略沉默中的偏好** | 用户懒得说但你该记住 | 偏好信号("我喜欢")→ 立即记录 |
+
+---
+
+## 学习推广示例
+
+### 案例 1:标签判定修正
+
+```
+用户:"这不是N(自然度违规),这是O(角色OOC)"
+→ [LRN-20260708-001] correction,Area: diagnosis
+→ 复发 3 次后推广
+→ 本 SKILL.md「诊断分析顺序」节写入新规则
+```
+
+### 案例 2:闸门漏拦
+
+```
+交付后用户发现结束条件不清晰
+→ [LRN-20260708-002] correction,Area: quality-gate
+→ 推广到「创建闸门」新增:"每个阶段有明确的退出条件"
+```
+
+### 案例 3:资产选错
+
+```
+微调"评分不准"时只查了评分组件库,漏了Bad Case库
+→ [LRN-20260708-003] correction,Area: asset
+→ 推广到「资产调用规则」微调按需选读:
+   "评分不准:必读评分组件库 + 同步查 Bad Case 中同类问题"
+```
+
+---
+
+## 周期性审查
+
+### 何时审查
+
+- 每次大任务开始前
+- 每次交付完成后
+- 每周主动检查一次
+
+### 快速状态
+
+```bash
+# 待处理数量
+grep -ch 'Status\*\*: pending' .learnings/*.md
+
+# 高优先级条目
+grep -B5 'Priority\*\*: high' .learnings/*.md | grep '^## \['
+```
+
+### 审查动作
+
+- 待处理 → 解决 → resolved
+- 满足推广条件 → promoted
+- 关联相关条目 → 加 See Also
+- 反复出现的问题 → 升级为独立 issue
+
+---
+
+## 技能自动提取
+
+### 提取条件(满足任一)
+
+- 有 2+ 个 See Also 关联(反复出现)
+- 状态 resolved 且有可工作修复
+- 需要实际排查才能发现(非显而易见)
+- 跨项目适用
+- 用户明确说"记下来"、"下次别忘了"
+
+### 提取流程
+
+1. 确认候选 learning 满足条件
+2. 使用 `assets/SKILL-TEMPLATE.md` 模板,创建 `skills/<skill-name>/SKILL.md`
+3. 更新原 learning:`**Status**: promoted_to_skill`、加 `Skill-Path`
+4. 在新 session 验证 skill 可独立使用
+
+---
+
+## 与主流程的集成点
+
+### 意图识别阶段
+
+- 检查 `.learnings/` 中是否有与当前任务 Area 匹配的 Priority=high/critical 且 Status=pending 的条目
+- 如有,在「意图识别」输出中追加:`⚠️ 历史学习提醒:XX(LRN-XXX)`
+
+### 诊断阶段
+
+- 每次打完诊断标签后,自动扫描用户反馈中的纠正关键词
+- 如检测到纠正 → 立即修正当前行为 → 异步写入 LEARNINGS.md,任务结束后推广
+
+### 交付阶段
+
+- 交付前跑闸门清单
+- 如闸门漏拦 → 写 LEARNINGS.md,标注 quality-gate Area
+
+### 任务收尾阶段
+
+每个完整任务结束时:
+
+- 执行自我反思(三问)
+- 输出简洁的学习摘要(新条目数量 + 关键洞察)
+- 如有反思 → 写入 LEARNINGS.md
+
+---
+
+## 辅助脚本与模板
+
+| 文件 | 用途 |
+|------|------|
+| `assets/LEARNINGS-TEMPLATE.md` | 学习条目记录模板 |
+| `assets/ERRORS-TEMPLATE.md` | 错误条目记录模板 |
+| `assets/FEATURE_REQUESTS-TEMPLATE.md` | 功能请求记录模板 |
+| `assets/SKILL-TEMPLATE.md` | 新技能创建模板 |
+
+---
+
+## 最佳实践
+
+1. **立刻记录** - 上下文在问题刚发生时最新鲜
+2. **具体明确** - 后续的自己需要快速理解
+3. **包含复现步骤** - 特别是错误
+4. **链接相关文件** - 方便修复
+5. **给出具体修复建议** - 不只是"调查一下"
+6. **积极推广** - 拿不准时,推广到本 SKILL.md 比漏掉好
+7. **定期审查** - 过时的 learning 没有价值
+8. **屏蔽敏感信息** - 不记录密钥、token、完整对话抄本
+9. **从纠正中学习,不从沉默中学习** - 没有显式纠正 = 没有教训
+10. **推广前先确认** - 3 次同类纠正后,问一句"这是否可以作为永久规则?"

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

@@ -0,0 +1,185 @@
+---
+name: soke-shared
+summary: 授客CLI共享基础（配置/登录/权限/错误处理/安全规则）
+version: 1.0.0
+description: "授客CLI共享基础：应用配置初始化、认证登录（auth login）、权限管理、错误处理、安全规则。当用户需要第一次配置（soke-cli auth login）、使用登录授权（soke-cli auth login）、遇到权限不足、或首次使用soke-cli时触发。"
+---
+
+# soke-cli 共享规则
+
+本技能指导你如何通过soke-cli操作授客AI资源，以及有哪些注意事项。
+
+## 配置初始化
+
+首次使用需运行 `soke-cli auth login` 完成应用配置。
+
+当你帮用户初始化配置时，引导用户按照交互式提示完成配置：
+
+```bash
+# 初始化配置
+soke-cli auth login
+```
+
+配置项包括：
+- `app_id`: 开放平台应用ID
+- `app_key`: 开放平台应用Key
+- `app_secret`: 开放平台应用Secret
+- `api_base_url`: API地址（默认: https://opendev.soke.cn）
+- `corpid`: 企业ID
+
+配置文件保存在 `~/.soke-cli/config.json`
+
+## 认证
+
+### 用户登录
+
+用户需要通过OAuth授权获取访问令牌：
+
+```bash
+# 用户登录授权
+soke-cli auth login
+```
+
+登录成功后，`access_token` 和 `refresh_token` 会自动保存到配置文件中。
+
+### Token管理
+
+- **access_token**: 用户访问令牌，用于调用API
+- **refresh_token**: 刷新令牌，用于获取新的access_token
+- Token过期后需要重新执行 `soke-cli auth login`
+
+### 查看当前配置
+
+```bash
+# 查看当前配置（不显示敏感信息）
+soke-cli config show
+```
+
+## 权限不足处理
+
+遇到权限相关错误时，通常有以下几种情况：
+
+### 1. 未登录或Token过期
+
+**错误特征**: 返回401 Unauthorized或Token无效
+
+**解决方案**:
+```bash
+soke-cli auth login
+```
+
+### 2. 缺少必要权限
+
+**错误特征**: 返回403 Forbidden或权限不足提示
+
+**解决方案**:
+- 联系管理员在开放平台后台为应用开通相应权限
+- 确认企业ID（corpid）和应用配置正确
+
+### 3. 参数错误
+
+**错误特征**: 返回400 Bad Request或参数验证失败
+
+**解决方案**:
+- 检查必需参数是否提供
+- 使用 `--help` 查看命令参数说明
+- 参考API文档确认参数格式
+
+## 命令结构
+
+### Shortcuts（推荐）
+
+Shortcuts是对常用操作的高级封装，参数友好，最适合AI Agent调用：
+
+```bash
+soke-cli <service> +<verb> [flags]
+```
+
+示例：
+```bash
+soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
+soke-cli course +list-courses --page 1 --page-size 10
+```
+
+### 通用API调用
+
+支持直接调用任意API：
+
+```bash
+soke-cli api <METHOD> <path> [--data <json>] [--params <json>]
+```
+
+示例：
+```bash
+soke-cli api GET /users/me
+soke-cli api POST /some/endpoint --data '{"key": "value"}'
+```
+
+## 输出格式
+
+### JSON格式（默认）
+
+所有命令默认输出JSON格式，便于程序解析：
+
+```bash
+soke-cli exam +list-exams --format json
+```
+
+### 表格格式
+
+部分命令支持表格格式输出，更易读：
+
+```bash
+soke-cli exam +list-exams --format table
+```
+
+## 安全规则
+
+- **禁止输出密钥**（app_secret、access_token）到终端明文
+- **写入/删除操作前必须确认用户意图**
+- 敏感操作建议先使用 `--dry-run`（如果支持）预览
+
+## 错误处理
+
+当命令执行失败时：
+
+1. **检查配置**: 运行 `soke-cli config show` 确认配置正确
+2. **检查登录状态**: 如果是认证错误，运行 `soke-cli auth login`
+3. **检查参数**: 使用 `soke-cli <service> <command> --help` 查看参数说明
+4. **查看错误信息**: 错误响应中通常包含详细的错误原因
+
+## 常见问题
+
+### Q: 如何获取app_key和app_secret？
+
+A: 登录授客AI开放平台（https://opendev.soke.cn），创建应用后即可获取。
+
+### Q: Token过期了怎么办？
+
+A: 重新执行 `soke-cli auth login` 进行授权。
+
+### Q: 如何切换企业？
+
+A: 运行 `soke-cli auth login` 重新配置，或直接编辑 `~/.soke-cli/config.json` 文件。
+
+### Q: 支持哪些业务模块？
+
+A: 目前支持以下模块：
+- `contact`: 组织架构（部门、用户、岗位、讲师）
+- `course`: 课程管理
+- `exam`: 考试管理
+- `training`: 培训管理
+- `learning_map`: 学习地图
+- `credit`: 学分管理
+- `point`: 积分管理
+- `news`: 资讯管理
+- `certificate`: 证书管理
+- 等等...
+
+每个模块都有对应的Skill，AI Agent会根据用户意图自动选择。
+
+## 相关链接
+
+- 授客AI开放平台: https://opendev.soke.cn
+- NPM包: @sokeai/cli
+- 代码仓库: https://codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli.git

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

@@ -0,0 +1,17 @@
+# Part1 基础信息创建子 SOP
+
+> 由 SKILL.md Step 5 调用。生成前先读 `coaching/prompt-engineer/parts/part1-basic.md` 加载内容框架。执行流程遵循「展示 → 自检 → 弹窗确认（模板1）→ 后台创建」。
+
+## 固定约束
+
+- 场景语言 `scene_lang` 固定 `"简体中文"`（永不随场景变）。
+- 封面固定默认 URL `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`（确认后后台写入）。
+- `key_points` 必须**单个字符串**（多条用分号/编号拼接，非数组）。
+
+## 执行流程
+
+1. 完整展示 Part1 → 自检 → 2. 弹窗确认 → 3. 生成 step1-create.json → 4. 执行 `+create-scenario` → 5. 回读验收 name/description/tags/key_points 一致，scenario_id 非空（为空禁止进 Part2）。
+
+## 自查清单（7 项）
+
+1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang="简体中文"；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。