$npx -y skills add arch-team/devpace --skill pace-learnUse when user says "/pace-learn", "经验", "知识库", "pattern", "lessons learned", "学到了什么", or auto-invoked after CR merge, gate failure recovery, or human rejection. NOT for iteration retrospectives or metrics (use /pace-retro). NOT for concept explanations (use /pace-theory).
| 1 | # /pace-learn — 经验积累与知识管理 |
| 2 | |
| 3 | devpace 的学习引擎。双模式运行: |
| 4 | |
| 5 | - **自动模式**(主体):在关键事件后静默提取经验 pattern 到 `.devpace/metrics/insights.md` |
| 6 | - **手动模式**:用户通过子命令管理知识库 |
| 7 | |
| 8 | ## 子命令路由 |
| 9 | |
| 10 | **重要**:根据触发方式(自动/手动)和子命令,仅读取路由表中对应的 procedures 文件,不加载其他 procedures。 |
| 11 | |
| 12 | | 子命令 | 说明 | 详见 | |
| 13 | |--------|------|------| |
| 14 | | (无参数/自动触发) | 事件驱动的自动学习 | 本文件"自动模式流程" + `skills/pace-learn/learn-procedures.md` | |
| 15 | | `note <描述>` | 手动沉淀探索中的有价值经验 | `skills/pace-learn/learn-procedures-query.md` §1 | |
| 16 | | `list [--type TYPE] [--tag TAG] [--confidence MIN]` | 按条件筛选 pattern | `skills/pace-learn/learn-procedures-query.md` §2 | |
| 17 | | `stats` | 知识库统计概览 | `skills/pace-learn/learn-procedures-query.md` §3 | |
| 18 | | `export [--path FILE]` | 导出可复用经验 | `skills/pace-learn/learn-procedures-query.md` §4 | |
| 19 | | `prune [--dry-run] [--decay-only]` | 清理低置信度/过期条目 | `skills/pace-learn/learn-procedures-query.md` §5 | |
| 20 | |
| 21 | ## 自动触发场景 |
| 22 | |
| 23 | | 触发事件 | 事件类型 | 学习重点 | 提取目标 | |
| 24 | |---------|---------|---------|---------| |
| 25 | | CR merged | `merged` | 成功模式 | 可复用的检查项、高效的工作路径 | |
| 26 | | Gate fail | `gate1_fail` / `gate2_fail` | 失败教训 | 检查项阈值调整、Claude 盲区识别 | |
| 27 | | 人类打回 | `rejected` | 理解差距 | 意图理解偏差模式、审查标准校准 | |
| 28 | | 挣扎信号 | `struggle` | 环境缺陷识别 | Skill/procedures/Schema 改进建议 | |
| 29 | |
| 30 | 触发源由 `hooks/post-cr-update.mjs` 检测并输出 `devpace:learn-trigger` 提醒。 |
| 31 | |
| 32 | ## 自动模式流程 |
| 33 | |
| 34 | **重要**:自动模式按以下步骤执行,仅读取 `skills/pace-learn/learn-procedures.md` 中对应 Step,不加载 `skills/pace-learn/learn-procedures-query.md`。 |
| 35 | |
| 36 | ### Step 1:前置检查 |
| 37 | |
| 38 | 检查 `.devpace/` 是否存在——不存在则静默退出。存在则按触发源确定提取方向(merged→成功 pattern | Gate fail→防御 pattern | rejected→改进 pattern)。 |
| 39 | |
| 40 | ### Step 2:提取 Pattern |
| 41 | |
| 42 | 读取 `skills/pace-learn/learn-procedures.md` Step 2 执行。 |
| 43 | |
| 44 | ### Step 3:对比与积累 |
| 45 | |
| 46 | 读取 `skills/pace-learn/learn-procedures.md` Step 3 执行。 |
| 47 | |
| 48 | ### Step 4:嵌入式反馈 |
| 49 | |
| 50 | 读取 `skills/pace-learn/learn-procedures.md` Step 4 执行。 |
| 51 | |
| 52 | ## 输出 |
| 53 | |
| 54 | - **自动模式**:嵌入式 1 行通知(有新 pattern 时),或静默(无有价值发现时) |
| 55 | - **手动模式**:按子命令输出,详见 `skills/pace-learn/learn-procedures-query.md` |
| 56 | |
| 57 | ## 约束 |
| 58 | |
| 59 | - 不修改 CR 文件或其他状态文件(仅写入 insights.md) |
| 60 | - 不中断当前工作流 |