@namewta/speculo 1.0.22 → 2.0.1

package/template/workflows/learning/learning-g-goal/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: learning-g-goal
+description: "为选定编程项目编译一份可被外部 /goal 执行的完整 Goal-Plan；计划会话可跟随 A 写出课程地图并按库存切 ≤15 的 mine unit，但不写 Lesson、不进行教学探针提问、不自动串联 H/R/C。"
+metadata:
+  speculo-kind: work-skill
+  speculo-id: learning/goal
+  speculo-domain: learning
+  speculo-contract-version: "2"
+---
+
+# 目标学习（目标模式）
+
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/common/rules/domain-runtime.md</Path>`。
+
+G-goal 是计划编译器，不是授课编排器。激活后写出完整 Goal-Plan 并停止。授课、挖掘与验收由用户在 AI CLI 中 `/goal` 读取该计划执行：按项目规模划出一个不超过 15 节的教学单元 → 先把这个单元的课全部写完 → 再为每一课派 miner。
+
+## 读取范围
+
+当前步骤开始前，读取 `<Path>{roots.workflows}/learning/common/rules/lesson-contract.md</Path>`；只加载本 Work 需要的领域合同。
+
+读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前 Change、OBJ、主题与证据 ID 定位本轮输入；仅当前恢复或安全门要求时扩读。
+
+## 模式
+
+| 用户意图 | 模式 | 谁执行 | 必须按需读取 |
+| --- | --- | --- | --- |
+| 选定项目并生成完整计划（默认） | `plan` | 本 Work | `<Path>{roots.workflows}/learning/learning-g-goal/references/planning-modes.md</Path>`、`<Path>{roots.workflows}/learning/learning-g-goal/assets/goal-plan-template.md</Path>`、`<Path>{roots.workflows}/learning/learning-a-assess-and-plan/SKILL.md</Path>`、`<Path>{roots.workflows}/learning/learning-g-goal/references/mine-unit.md</Path>` |
+| 源码或范围变化，重编译计划 | `replan` | 本 Work | 同上，加 `<Path>{roots.workflows}/learning/learning-g-goal/references/orchestration-protocol.md</Path>`；旧 `goal-plan.md` 只读归档到 `goal/revisions/` |
+| 按计划写课与挖掘 | `run` / `resume` | 外部 `/goal` | 计划正文 §5 / §8；本 Work 不在激活会话内执行 |
+| 对照矩阵验收 | `verify` | 外部 `/goal`，或以后再激活本 Work 只读验收 | 计划正文 §6 与 `<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>` |
+
+`plan` 写出的文档不构成执行授权。`ready_for_execution: false`，直到用户把计划交给 `/goal`。
+
+## 流程
+
+1. 解析 roots 与 Learning v2 状态。roots 必须来自已打开的 `<Path>{roots.state}/workspace.json</Path>`。若尚无 `status.json` / `locations.json`，先按 `<Path>{roots.workflows}/learning/learning-i-init-setup/SKILL.md</Path>` 写入空状态骨架，不创建知识条目。
+2. 仅澄清计划范围，不生成教学问题或要求学习者作答课程探针。范围访谈一次只问一个缺口：项目路径、in-scope 模块/公开 API、out-of-scope、`expression_level`、`coverage_depth`。用户已答过不重复问。
+3. 创建或恢复 `YYYY-MM-DD-<kebab-topic>[-NN]` Change，生成 `.status.json`，设置 `phase=planning`、`current_work=learning/goal`。
+4. 读取目标仓库，做编程库存：C4 Context + Container、公开入口、主数据存储、一条主路径与一条失败路径、按模块归组的范围内函数。琐碎 helper、生成代码、测试夹具标 `covered-by-parent` 或 `deferred`，不为它们开课。Lead 可派只读库存员。
+5. 若本 Change 尚无可用 `course.md`，跟随 `<Path>{roots.workflows}/learning/learning-a-assess-and-plan/SKILL.md</Path>` 写出 `course.md`、`background/foundation.md`、`baseline.md`、`sources.md` 和 Change `INDEX.md`。这些文件仍归 A 所有；本 Work 只在编译计划时走 A 合同。已有课程地图则核对，不默默重写。
+6. 按模式表的 Goal-Plan 模板及 `<Path>{roots.workflows}/learning/learning-g-goal/assets/chain-template.md</Path>`、`<Path>{roots.workflows}/learning/learning-g-goal/assets/coverage-matrix-template.md</Path>`、`<Path>{roots.workflows}/learning/learning-g-goal/assets/progress-template.md</Path>` 写出完整计划，禁止留下「待调研」章节，禁止预写探针题目或深化讲义；按库存把课装进 mine unit（每个 ≤15 节，写入 `chain.md` Units 表）：
+   - `<Path>{roots.state}/learning/changes/{change}/goal/goal-plan.md</Path>`
+   - `<Path>{roots.state}/learning/changes/{change}/goal/chain.md</Path>`
+   - `<Path>{roots.state}/learning/changes/{change}/goal/coverage-matrix.md</Path>`
+   - `<Path>{roots.state}/learning/changes/{change}/goal/progress.md</Path>`（检查点骨架）
+7. 计划必须内嵌可粘贴的 `/goal` 启动块，并列出最小读取清单。覆盖规则读 `<Path>{roots.workflows}/learning/learning-g-goal/references/coverage-bar.md</Path>`；停止规则读 `<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>`；执行器合同读 `<Path>{roots.workflows}/learning/learning-g-goal/references/external-goal-runner.md</Path>`。
+8. 设置 `ready_for_execution: false`。更新 `learning-log.md` 与 Change `.status.json`：`works_run` 追加 `learning/goal`，清空 `current_work`。向用户打印 Goal-Plan 路径和 `/goal` 粘贴块。
+9. 停止。不写 `lessons/`，不写 `goal/probes/`，不创建 `inquiry/` 批次，不自动激活 L/H/R/C/A-archive，不写 mastered。
+
+## 完成标准
+
+- `goal/goal-plan.md` 按模板填实 Outcome、范围、四轴合同、Chain、Wave、mine unit、派单菜谱、授权矩阵、DoD、HARD NO、Resume 和最小读取清单；
+- `course.md` 有可观察 OBJ；`chain.md` 与矩阵使用库存得到的真实模块名，不是占位符；
+- `chain.md` 有 mine unit 列表，每个 unit ≤15（`mine_unit_cap`）；小项目允许远小于 15；不得为凑满 15 而灌水开课；
+- 计划不得预写探针题目或深化讲义；
+- 计划会话结束时 `lessons/` 仍无讲义正文（只允许空 INDEX）；
+- 粘贴块含 Outcome、verification surface、constraints、boundaries、iteration policy（teach-then-mine、10 问上限、`split-lesson`、Lead 扇出、unit ≤15）、blocked-stop；
+- 文档中的「允许」不构成 `/goal` 之外的额外授权；
+- 不复活 `Q-quiz`，不把 mine 写成学习者问答课。
+
+## 无 slash-command 宿主
+
+`/goal` 是宿主适配示例，不是额外授权源。宿主没有该命令时，用户可在新执行会话明确请求“按此 Goal-Plan 执行”，同时提供计划路径；该会话成为外部执行器并遵守相同最小读取清单、owner、停止和验收合同。计划会话仍只编译并停止，不自动接管执行。无 team 时按原派单包串行执行；缺必需文件或工具只阻塞受影响分支，不伪造子代理调用。30–40 分钟、每单元 ≤15 节与每课最多10问仍是 Learning 领域合同，不传播为全局 Agent 限制。

package/template/workflows/learning/learning-g-goal/assets/goal-plan-template.md

@@ -0,0 +1,310 @@
+---
+schema_version: 1
+artifact: learning-goal-plan
+change: YYYY-MM-DD-<kebab-topic>
+topic: <topic-id>
+project_path: <path-to-source-repo>
+status: draft
+modes: [plan]
+orchestration: external-goal
+run_orchestration: lead-directed
+coverage_domain: programming
+expression_level: plain
+coverage_depth: standard
+mine_unit: project
+mine_unit_cap: 15
+learning_agent_limit: 4
+max_waves: 2
+ready_for_execution: false
+---
+
+# Goal-Plan: <主题>
+
+本文件由 G-goal 在 `plan` / `replan` 会话编译。计划正文里的「允许」不构成执行授权。`ready_for_execution: false`，直到用户把本计划交给外部 AI CLI `/goal`。
+
+## 路径
+
+- 本计划：`<Path>{roots.state}/learning/changes/{change}/goal/goal-plan.md</Path>`
+- Chain：`<Path>{roots.state}/learning/changes/{change}/goal/chain.md</Path>`
+- 覆盖矩阵：`<Path>{roots.state}/learning/changes/{change}/goal/coverage-matrix.md</Path>`
+- 进度：`<Path>{roots.state}/learning/changes/{change}/goal/progress.md</Path>`
+- 挖掘探针：`<Path>{roots.state}/learning/changes/{change}/goal/probes/</Path>`
+- 验收：`<Path>{roots.state}/learning/changes/{change}/goal/verify.md</Path>`
+- 旧计划：`<Path>{roots.state}/learning/changes/{change}/goal/revisions/</Path>`
+- 课程地图（A 所有）：`<Path>{roots.state}/learning/changes/{change}/course.md</Path>`
+- 讲义（L 所有）：`<Path>{roots.state}/learning/changes/{change}/lessons/</Path>`
+- 问答课（Q 所有，`/goal` 不得写入）：`<Path>{roots.state}/learning/changes/{change}/inquiry/</Path>`
+
+---
+
+## §0 `/goal` 粘贴块
+
+把下面整块复制到 AI CLI 后发送 `/goal`。不要改写 Outcome 或 HARD NO。
+
+```text
+/goal READ <Path>{roots.state}/learning/changes/{change}/goal/goal-plan.md</Path>
+
+Outcome:
+  范围内覆盖矩阵格子全部变为 covered | deferred(reason) | covered-by-parent；
+  每个 chain 节点有一份 L 合同 Lesson；
+  每节新课或改写课至多两份 goal/probes/GP-*-b0N.md（每课 ≤10 问）；
+  写好 goal/verify.md。
+
+Verification surface:
+  goal/coverage-matrix.md 状态列；
+  lessons/L-*.md 存在且满足 L-lesson 合同；
+  goal/probes/GP-*.md 关闭态且至少改变过一个矩阵格子，或显式 defer / split-proposal；
+  goal/verify.md 对照 stop-rules 逐条勾选。
+
+Constraints:
+  roots 只来自已打开的 workspace.json；
+  只写当前 Change 的 lessons/ 与 goal/；
+  派单跟随 L-lesson 与 socratic-questioning audience=mine；
+  不发明库存里没有的函数；
+  mine unit ≤15；每课最多 10 问。
+
+Boundaries:
+  不写 inquiry/、homework/、review/、synthesis/、archive/；
+  不写 mastered；
+  不复活 Q-quiz；
+  不把 mine 写成学习者问答课；
+  不自动激活 H/R/C/A-archive。
+
+Iteration policy:
+  先按 goal/chain.md 的当前 mine unit 写完该单元全部 L（阶段 T），再按课扇出 mine（阶段 M）；
+  禁止 L → mine → L → mine 交错；
+  并行只发生在写集不相交的子代理之间；矩阵、chain、progress、verify、lessons/INDEX 只有 Lead 可写；
+  处置：re-dispatch-L | split-lesson | defer(reason)；
+  mine-more 只允许在该课尚未满 10 问、且 batch-01 已证明存在真实矩阵缺口时，用来打开 b02；
+  满 10 问后 mine-more 非法；
+  当前 mine unit 课数不得超过 15。超过则停止，回到 G-goal replan 重新切单元。
+
+Blocked-stop:
+  本单元矩阵无变化；出现第 11 问；交错 L/mine；miner 写入 lessons/ 或 matrix；
+  同一 unit 规划超过 15 节；用户暂停；
+  缺源码 / 缺 baseline / 目标无法核对；所有权冲突或路径越界。
+```
+
+最小读取顺序见 §11。
+
+---
+
+## §1 Outcome and Authority
+
+### Outcome
+
+合格读者读完本 Goal 后，能用范围内源码与已写成的 Lesson 说明：系统 Context 与 Container、一条主路径与一条失败路径、范围内公开/领域函数的目的，以及公开 API / 枢纽方法的副作用与失败路径。完成证据是矩阵闭合 + Lesson + probe + `goal/verify.md`，不是「课写完」。
+
+### Success and False Completion
+
+算完成：stop-rules 的「完成即停」全部满足。
+
+不算完成：
+
+- 课写完
+- 文件巡览结束
+- 模型表示「已经理解」
+- 主观百分比
+- 只生成了 Goal-Plan 本身
+
+### Non-goals
+
+- 不自动激活 `H-homework`、`R-review`、`C-consolidate`、`A-archive`
+- 不写 mastered
+- 不复活 `Q-quiz`
+- 不使用 `Q-question` 的 `inquiry/` Response 协议
+- 不为琐碎 helper、生成代码、测试夹具单独开课
+- 不在本计划里预写探针题目或深化讲义
+
+### Authoritative Inputs
+
+| 优先级 | 输入 | 用途 |
+| --- | --- | --- |
+| 1 | 用户当场决定 | 覆盖范围、暂停、defer |
+| 2 | `course.md` OBJ | 权威学习目标；本文件不改写 OBJ |
+| 3 | `goal/coverage-matrix.md` | 格子状态是覆盖权威 |
+| 4 | `goal/chain.md` | 课程序列投影与 mine unit 切分 |
+| 5 | 本计划派单菜谱 | `/goal` 只按 §5 / §7 行动 |
+| 6 | 源码事实 | 库存与证据；不得发明符号 |
+
+---
+
+## §2 Scope
+
+### In-scope
+
+- 项目路径：
+- 模块 / 公开 API：
+- 必须覆盖的容器：
+
+### Out-of-scope
+
+-
+
+### covered-by-parent / deferred
+
+- 琐碎 helper、生成代码、测试夹具：`covered-by-parent` 或 `deferred(reason)`
+- 「每一个函数」= 范围内公开/领域函数，不是仓库里每一个私有 one-liner
+- 不改变任何覆盖格子的 Lesson 或 probe 不要写
+
+### C4 库存快照
+
+```text
+[Context]
+  <system> --uses--> <actor / external>
+
+[Container]
+  <container-a>
+  <container-b>
+
+[Happy path]
+  <input> -> <transform> -> <store>
+
+[Fail path]
+  <input> -> <error>
+```
+
+范围内函数按模块归组，清单写在 `goal/coverage-matrix.md` 的 (a)(b) 表，不在本节约维护第二份过期名单。
+
+---
+
+## §3 Coverage Contract
+
+v1 只实现编程四轴。默认档与证据规则以 `<Path>{roots.workflows}/learning/learning-g-goal/references/coverage-bar.md</Path>` 为准。
+
+| 轴 | 对象 | 默认 SOLO | 证据 |
+| --- | --- | --- | --- |
+| (a) 函数目的 | 范围内公开/领域函数 | Unistructural + explained | Lesson 函数表或父课 covered-by-parent |
+| (b) 方法性状 | 公开 API 与枢纽内部方法 | Unistructural + explained | 副作用、失败路径、幂等、并发、纯/不纯 |
+| (c) 业务架构 | 系统与容器 | Relational | C4 Context + Container + 关键 Component 的 ASCII |
+| (d) 数据流 | 主路径与失败路径 | Relational | 源 → 变换 → 汇 + 存储点 + 所有权 |
+
+Extended Abstract 不是完成条件。
+
+---
+
+## §4 Chain, Waves, and Mine Units
+
+权威序列与 mine unit 切分在 `goal/chain.md`。本计划只记录覆盖波与挖掘单元门。Wave 是内容分组，不是挖掘门，也不是并发授权。
+
+| Wave | 焦点 | Lessons | 分组尺 | Gate |
+| --- | --- | --- | --- | --- |
+| 1 | C4 Context + Container + 主数据流 |  | 架构与数据流 | G1/G2/G3 |
+| 2 | 范围内公开 API 与方法性状 |  | 公开 API | G1/G2/G3 |
+
+| Mine unit | Lessons | 上限 | 状态 |
+| --- | --- | --- | --- |
+| U1 |  | ≤15（上界，不是配额） | planned |
+
+默认最多 `max_waves: 2`。`mine_unit: project`，`mine_unit_cap: 15`。小项目允许远小于 15。切分规则读 `<Path>{roots.workflows}/learning/learning-g-goal/references/mine-unit.md</Path>`。
+
+---
+
+## §5 Dispatch Recipe
+
+`/goal` 的 `run` / `resume` 只读本节与 §7 / §8。计划会话不得执行本节。编排读 `<Path>{roots.workflows}/learning/learning-g-goal/references/lead-orchestration.md</Path>`。拆课读 `<Path>{roots.workflows}/learning/learning-g-goal/references/split-rules.md</Path>`。
+
+运行形状是 **teach-then-mine**，不是一课一挖交错：
+
+1. **阶段 T**：按当前 mine unit 为每课派一个 L 子代理。跟随 `<Path>{roots.workflows}/learning/learning-l-lesson/SKILL.md</Path>` 与 `<Path>{roots.workflows}/learning/common/rules/teaching-policy.md</Path>`，写入各自的 `lessons/L-<NNN>-<slug>.md`。`lessons/INDEX.md` 只有 Lead 可写。本单元全部 planned 节点都有合格 L 合同讲义后，才进入阶段 M。
+2. **阶段 M**：为每课派一个 miner。跟随 `<Path>{roots.workflows}/learning/common/skills/socratic-questioning/SKILL.md</Path>` 且 `audience=mine`，按 `<Path>{roots.workflows}/learning/learning-g-goal/assets/probe-template.md</Path>` 写入 `goal/probes/GP-<lesson>-b01.md`（Q1–Q5）；若仍有真实矩阵缺口且预算未满 10，再开 `b02.md`（Q6–Q10）。审问对象是已写成的 Lesson 与源码，不是学习者。miner 不得写 `lessons/` 或 matrix。
+3. **阶段 D**：仅 Lead 根据各课缺口表与 `split-proposal` 处置：`re-dispatch-L` | `split-lesson` | `defer(reason)`。Lead 提交矩阵 / progress。满 10 问后禁止 `mine-more`。
+
+禁止：
+
+- 跟随 `Q-question` 的 `inquiry/` Response 协议
+- 自动激活 H / R / C / A-archive
+- 把 mine 写成学习者问答课
+- 在计划会话里写 `lessons/` 或 `goal/probes/`
+- 在 Goal-Plan 里预写探针题目或深化讲义
+- 阶段 T 完成前启动 miner
+- `L → mine → L → mine` 交错
+- 同一 `lesson_id` 第 11 问，或 `b03`
+
+---
+
+## §6 Gates and DoD
+
+停止规则以 `<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>` 为准。
+
+| Gate | 含义 | 证据 |
+| --- | --- | --- |
+| G0 | 计划已编译 | `goal/goal-plan.md`、`chain.md`、`coverage-matrix.md`、`progress.md` 存在；`course.md` 有可观察 OBJ；每个 mine unit ≤15 节 |
+| G1 | 本单元全部 planned 节点已写成合格 L 合同讲义 | `lessons/L-*.md`；progress 显示本 unit 先进入 `written` |
+| G2 | 本单元至少改变一个矩阵格子 | 矩阵 diff + `progress.md` 一行事实 |
+| G3 | 本单元新课或改写课有对应 probe，且每课 Q 数 ≤10 | `goal/probes/GP-*-b0N.md` |
+| G-final | 范围内格子全部闭合且已验收 | 矩阵无 uncovered；`goal/verify.md` 已写 |
+
+Overall Definition of Done = G-final。课写完不是 DoD。阶段 T 结束之前禁止 miner。阶段 M 结束之前，Lead 不得把「课写完」写成 Goal 完成。
+
+---
+
+## §7 Authorization Matrix
+
+| 动作 | plan 会话 | `/goal` Lead | L 子代理 | Miner 子代理 |
+| --- | --- | --- | --- | --- |
+| 跟随 I 写空骨架 | 允许 | 不授权 | 不授权 | 不授权 |
+| 跟随 A 写/核 course 地图 | 允许 | 不授权 | 不授权 | 不授权 |
+| 写 goal-plan / chain 骨架 | 允许 | run 中可追加 split 子节点、切 unit | 不授权 | 不授权 |
+| 更新 matrix / progress | 只写骨架 | 允许（独占） | 不授权 | 不授权 |
+| 写 `lessons/L-*.md` | 不授权 | 不代替 writer | 仅自己的文件 | 不授权 |
+| 写 `goal/probes/` | 不授权 | 不代替 miner | 不授权 | 仅自己的 `GP-b0N` |
+| 写 `goal/verify.md` | 不授权 | 停止规则触发后允许 | 不授权 | 不授权 |
+| `inquiry/` `homework/` `review/` `synthesis/` `archive/` mastered | 禁止 | 禁止 | 禁止 | 禁止 |
+
+文档中的「允许」不构成 `/goal` 之外的额外授权。
+
+---
+
+## §8 Constraints / HARD NO
+
+- 不复活 `Q-quiz`
+- mine ≠ 学习者 Q/A；禁止 `inquiry/`、`Response:`、`Submission:`、`verdict`、mastered
+- 不自动串联 H / R / C / A-archive
+- 路径只用 `<Path>{roots.*}/...</Path>`；roots 必须来自已打开的 `workspace.json`
+- 不发明库存里没有的函数、容器或数据流
+- 不把 Wave 当成挖掘门或并发授权
+- 不把 Extended Abstract 当成完成条件
+- 不把计划会话里的「已批准 / 允许」当成执行授权
+- 不预写探针题目，不在 Goal-Plan 里写深化讲义
+- 不在阶段 T 完成前启动 miner
+- 不交错 L 与 mine
+- 同一 `lesson_id` 第 11 问非法；满 10 问禁止 mine-more
+- miner 不得选择处置，只填表
+- `split-lesson` 不得调用 `C-consolidate` 或 `relocate-learning.mjs`
+- 同一 mine unit 不得超过 15 节；不得把 16+ 节一次扇出
+- 宿主没有 team 时，不得借机退回旧交错循环
+
+---
+
+## §9 Resume Protocol
+
+恢复时只读：
+
+1. 本文件 §0、§5、§7、§8
+2. `goal/progress.md` 当前 `mine_unit` 与阶段
+3. 最近一份 `goal/probes/GP-*.md`
+4. `goal/chain.md` 的 Units 表与当前 unit 内状态为 `writing` / `written` / `mined` / 下一个 `planned` 的节点
+
+从最后一个改变了矩阵格子的检查点继续。仍覆盖有效格子的 Lesson 不删除、不重写。源码或范围变了先回到 G-goal `replan`，不要在 `/goal` 里偷偷扩 scope。当前 unit 若尚未全部 `written`，先完成阶段 T，禁止提前 mine。
+
+---
+
+## §10 Progress
+
+只记录可核对事实，权威表在 `goal/progress.md`。不准写主观百分比。progress 必须能看出当前 unit 全部 L 先进入 `written`，再进入 `mined`。
+
+---
+
+## §11 Minimum read order for `/goal`
+
+1. 已打开的 `<Path>{roots.state}/workspace.json</Path>`
+2. 本计划 §0、§5、§7、§8
+3. `goal/chain.md` 当前 mine unit
+4. `<Path>{roots.workflows}/learning/learning-g-goal/references/lead-orchestration.md</Path>` 与 mine-unit / split-rules
+5. 阶段 T：`<Path>{roots.workflows}/learning/learning-l-lesson/SKILL.md</Path>` 与 teaching-policy
+6. 本单元全部 L 写成后：`probe-template.md` + `<Path>{roots.workflows}/learning/common/skills/socratic-questioning/SKILL.md</Path>` 且 `audience=mine`
+7. `goal/coverage-matrix.md` + `<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>`
+8. 停止规则触发后写 `goal/verify.md`
+
+不要整读 archive、其他 Change，或 `inquiry/`。

package/template/workflows/learning/learning-g-goal/assets/probe-template.md

@@ -0,0 +1,64 @@
+---
+artifact: learning-goal-probe
+probe_id: GP-<lesson>-b0N
+lesson_id: L-<NNN>-<slug>
+audience: mine
+batch: b01
+question_budget_used: 0
+split_depth: 0
+status: open
+---
+
+# Probe GP-<lesson> / b0N
+
+审问对象是已写成的 Lesson 与源码，不是学习者。禁止 `inquiry/`、`Response:`、`Submission:`、`verdict`、mastered。`b01` 承载 Q1–Q5；`b02` 承载 Q6–Q10。禁止 `b03`。miner 不得写 `lessons/`。
+
+`question_budget_used` 按 `lesson_id` 累计。`re-dispatch-L` 不重置该课预算。
+
+## Q1 澄清
+
+哪些范围内单元被这节课声称覆盖？
+
+## Q2 证据
+
+源码里哪些函数、容器或数据流真正被讲到？
+
+## Q3 假设与反例
+
+合格读者读完后仍说不出什么？具体遗漏了哪个假设、边界或失败情境，为什么容易漏掉，忽略会改变什么判断？不要仅因材料未提到就断言学习者不理解。
+
+## Q4 视角
+
+架构边或数据流边缺了哪一条？相关时检查重复执行、结果未知、恢复与无进展循环；说明处理责任层、所需证据和可观察的验证条件，不只列“重试/监控”。
+
+## Q5 元问题
+
+`mine-more` | `defer` | `re-dispatch-L` | `split-lesson`，原因：
+
+（`b02` 的元问题是 Q10，选项相同。满 10 问后 `mine-more` 非法，只允许 `split-lesson` / `defer` / `re-dispatch-L`。）
+
+## 缺口清单
+
+| 格子 | 缺口 | 建议补丁 | 处置建议 |
+| --- | --- | --- | --- |
+|  |  |  | mine-more / defer / re-dispatch-L / split-lesson |
+
+每个主要缺口在表后追加遗漏原因、触发/父问题、证据与待验证项；新的 b02 应带来增量，不重复 b01。
+
+Miner 只填表，不选择最终处置。
+
+## split-proposal
+
+10 问后仍不清，或操作定义触发时填写；否则写 `none`。
+
+| 原 lesson_id | 建议新课标题 | 从原课拿走的格子 | 为什么 10 问不够 |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+Lead 裁决：新课进当前或下一 mine unit；当前 unit 加进去会超过 15 则开新 unit。不得调用 `C-consolidate` 或 `relocate-learning.mjs`。
+
+## 关闭
+
+- 状态：`open` | `patched` | `deferred` | `split_proposed` | `closed`
+- `question_budget_used`：
+- 是否改变了至少一个矩阵格子，或显式 `defer` / `split-proposal`：

package/template/workflows/learning/learning-g-goal/assets/progress-template.md

@@ -0,0 +1,19 @@
+# Progress: <主题>
+
+只记录可核对事实。不准写主观百分比。当前 mine unit 必须全部 L 先进入 `written`，再进入 `mined`。
+
+| 时间 | mine_unit | Wave | Gate | 写入文件 | 矩阵变化 | Blocker |
+| --- | --- | --- | --- | --- | --- | --- |
+|  | U1 | 0 | G0 | goal/goal-plan.md | 骨架已建 |  |
+
+## 当前
+
+- current_mine_unit:
+- current_phase: `T` | `M` | `D` | `idle`
+- 本单元课数:
+- question_budget_used:（按 lesson_id 累计，re-dispatch-L 不重置）
+- active_executors:
+- 仍 uncovered:
+- 下一 ready 节点:
+- 最近 probe:
+- 恢复入口：重读 goal-plan.md §8

package/template/workflows/learning/learning-g-goal/references/coverage-bar.md

@@ -0,0 +1,36 @@
+# 覆盖尺（v1 编程）
+
+v1 只实现编程四轴。其他领域可同构为 units / properties / structure / flow，但不在 v1 生成完整矩阵。
+
+## 四轴
+
+| 轴 | 对象 | 默认 SOLO | 证据 |
+| --- | --- | --- | --- |
+| (a) 函数目的 | 范围内公开/领域函数 | Unistructural + explained | Lesson 函数表或父课 covered-by-parent |
+| (b) 方法性状 | 公开 API 与枢纽内部方法 | Unistructural + explained | 副作用、失败路径、幂等、并发、纯/不纯 |
+| (c) 业务架构 | 系统与容器 | Relational | C4 Context + Container + 关键 Component 的 ASCII |
+| (d) 数据流 | 主路径与失败路径 | Relational | 源 → 变换 → 汇 + 存储点 + 所有权 |
+
+## 范围规则
+
+- 「每一个函数」= 范围内公开/领域函数，不是仓库里每一个私有 one-liner
+- helper / 生成代码 / 测试夹具：`covered-by-parent` 或 `deferred(reason)`
+- Code 层不手维护过期清单；从源码生成库存，按模块归组
+- Extended Abstract 不是完成条件
+- 不改变矩阵格子的 Lesson 或 probe 不要写
+
+## Wave（内容分组，不是挖掘门）
+
+- Wave 1：Context + Container + 主数据流
+- Wave 2：范围内 Code / 方法性状
+- Wave 只按覆盖轴分组，不决定何时挖，也不是并发授权
+- 默认最多 2 波
+- 3 课的波不必撑到 15；单波若超过 15，只把挖掘切开，不把覆盖波扩成配额
+
+## 挖掘扇出
+
+挖掘扇出上界是 `mine_unit_cap=15`，不是必须凑满。4 节的小项目按 4 节挖。切分规则读 `<Path>{roots.workflows}/learning/learning-g-goal/references/mine-unit.md</Path>`。
+
+## 盲区发现与实际处置
+
+授课、miner 和覆盖验收读取 `<Path>{roots.workflows}/learning/common/rules/inquiry-depth-policy.md</Path>`；生产相关代码还读取 `<Path>{roots.workflows}/learning/common/rules/production-inquiry.md</Path>`。将相关发现映射回上述矩阵格子，记录遗漏原因、影响、源码证据和验证设计；不把假设情境写成已发生事故。共享方法不增加问题配额，不改变十问后拆课、unit 上限或计划/执行授权边界。

package/template/workflows/learning/learning-g-goal/references/external-goal-runner.md

@@ -0,0 +1,54 @@
+# 外部 /goal 执行器
+
+本文件只在 Goal-Plan 已写成、用户把计划交给外部 AI CLI `/goal` 之后读取。G-goal 激活会话不执行本文件。
+
+## 谁执行
+
+执行器是用户自己的 AI CLI `/goal`，不是 Learning Work 会话内的自动编排。`plan` 写出的文档不构成执行授权。`ready_for_execution: false` 一直保持到用户把计划交给 `/goal`。计划正文里的「允许」不构成 `/goal` 之外的额外授权。
+
+详细操作手册是当前 Change 的 `goal/goal-plan.md`。本文件只固定执行器边界。Lead 编排读 `<Path>{roots.workflows}/learning/learning-g-goal/references/lead-orchestration.md</Path>`。
+
+## 启动
+
+1. 打开含 `<Path>{roots.state}/workspace.json</Path>` 的项目；roots 只来自该文件。
+2. 粘贴当前 `goal-plan.md` 的 §0 `/goal` 块。
+3. 按该计划 §11 最小读取清单读；不整读 archive、`inquiry/` 或其他 Change。
+4. 不要重新做范围访谈。范围已冻在计划里。源码或范围变化则停止，要求用户激活 G-goal `replan`。
+
+## 允许跟随
+
+- `<Path>{roots.workflows}/learning/learning-l-lesson/SKILL.md</Path>`：写 `lessons/L-*.md`（阶段 T，每课一个 L 子代理）
+- `<Path>{roots.workflows}/learning/common/skills/socratic-questioning/SKILL.md</Path>` 且 `audience=mine`：写 `goal/probes/GP-*.md`（阶段 M，每课一个 miner）
+
+必须加载 socratic-questioning SKILL，路径固定为 `{roots.workflows}/learning/common/skills/socratic-questioning/SKILL.md`。不得另造配方。
+
+派单不改所有权。A 仍拥有 course 地图，L 仍拥有 lessons，G 拥有 `goal/`，Q 拥有 `inquiry/`。矩阵、chain、progress、verify、`lessons/INDEX` 只有 Lead 可写。
+
+## 禁止
+
+- `Q-question` 的 `inquiry/` Response 协议
+- 自动激活 H / R / C / A-archive
+- 写 mastered
+- 复活 `Q-quiz`
+- 把 mine 写成学习者问答课
+- 为不改变矩阵格子的主题另开课
+- 发明库存里不存在的函数、容器或数据流
+- 阶段 T 完成前启动 miner
+- `L → mine → L → mine` 交错
+- 同一 `lesson_id` 第 11 问或 `b03`
+- miner 写入 `lessons/` 或 matrix
+- 同一 mine unit 超过 15 节
+
+## 循环
+
+当前 mine unit 全部 L（阶段 T）→ 按课 mine（阶段 M）→ Lead 处置（阶段 D）→ 下一 unit。禁止交错。并行只发生在写集不相交的子代理之间。宿主没有 team 时按相同派单包顺序执行，合同不降级。
+
+处置只允许：`re-dispatch-L` | `split-lesson` | `defer(reason)`。`mine-more` 只允许在该课尚未满 10 问、且 batch-01 已证明存在真实矩阵缺口时打开 `b02`。满 10 问后 `mine-more` 非法。
+
+## 停止
+
+读 `<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>`。任一过程即停或完成即停触发后，写 `goal/verify.md`：哪些格子闭合、哪些 deferred、哪些仍 uncovered、恢复入口。课写完不是完成。
+
+## 无 slash-command 宿主
+
+`/goal` 是宿主适配示例，不是额外授权源。宿主没有该命令时，用户可在新执行会话明确请求“按此 Goal-Plan 执行”，同时提供计划路径；该会话成为外部执行器并遵守相同最小读取清单、owner、停止和验收合同。计划会话仍只编译并停止，不自动接管执行。无 team 时按原派单包串行执行；缺必需文件或工具只阻塞受影响分支，不伪造子代理调用。30–40 分钟、每单元 ≤15 节与每课最多10问仍是 Learning 领域合同，不传播为全局 Agent 限制。

package/template/workflows/learning/learning-g-goal/references/lead-orchestration.md

@@ -0,0 +1,52 @@
+# Lead 编排与派单（Learning `/goal`）
+
+本文件只在外部 `/goal` 执行 Goal-Plan，或 G-goal `plan` / `replan` 需要派只读库存员 / A 子代理时读取。不引入 SpecDev 的 Ticket / worktree / Evidence 协议。并发单位是「一个 Lesson 文件」或「一份 probe 文件」。
+
+抄 SpecDev `P-goal-plan` 的 lead-directed：主会话是唯一 Lead。Learning 不把 Lead 写进 Ticket；Lead 是当前 `/goal`（或 plan）主会话。
+
+## 角色与写集
+
+| 角色 | 何时出现 | 可以写 | 禁止写 | 必须读取 |
+| --- | --- | --- | --- | --- |
+| Lead（`/goal` 主会话，或 plan 主会话） | 始终 | `goal-plan` / `chain` / `matrix` / `progress` / `verify` / `lessons/INDEX` / `learning-log` / `.status.json` | 不得代替 L 写讲义正文，不得代替 miner 编造探针 | 已打开的 `workspace.json`、Goal-Plan §0/§5/§7/§8、`<Path>{roots.workflows}/learning/learning-g-goal/references/stop-rules.md</Path>`、本文件、`<Path>{roots.workflows}/learning/learning-g-goal/references/mine-unit.md</Path>`、`<Path>{roots.workflows}/learning/learning-g-goal/references/split-rules.md</Path>` |
+| 库存员（只读） | plan 可选 | 无 | 任何状态与知识文件 | 目标仓库源码，产出 C4 与函数分组给 Lead |
+| A 子代理 | plan 且尚无 `course.md` | `course.md`、background、baseline、sources、Change INDEX | `goal/`、`lessons/`、`probes/` | `A-assess-and-plan` 合同 |
+| L 子代理 | `/goal` 阶段 T，每课一个 | 仅被分配的 `lessons/L-<NNN>-<slug>.md` | 其他 L 文件、INDEX、`goal/`、`inquiry/` | `L-lesson.md` + teaching-policy + 该课 OBJ 与矩阵行 |
+| Miner 子代理 | `/goal` 阶段 M，每课一个 | 仅 `GP-<lesson>-b01.md` 与（若仍有预算）`b02.md` | `lessons/`、chain、matrix、`inquiry/`、其他课的 probe | 下面这条 skill 路径 + questioning-policy + 该课 Lesson + 源码锚点 + 该课声称覆盖的矩阵行 |
+
+Miner 必须加载的 skill 路径（不得另造配方）：
+
+```text
+{roots.workflows}/learning/common/skills/socratic-questioning/SKILL.md
+```
+
+## 派单包最低字段
+
+每次派单必须包含：`lesson_id` 或 change 范围、只读路径、唯一可写路径、允许动作、停止条件、返回格式。Miner 包还必须包含该课声称覆盖的矩阵行，以及上述 skill 合同路径。`audience` 固定为 `mine`。
+
+L 返回至少：`lesson_id`、写入路径、是否满足 L 合同章节、声称覆盖的格子。Miner 返回至少：`lesson_id`、`probe_id`、`question_budget_used`、缺口表、Q5/Q10 建议（`mine-more` | `defer` | `re-dispatch-L` | `split-lesson`）、可选 `split-proposal`。Miner 只填表，不选择处置。
+
+## 并发边界
+
+- `learning_agent_limit` 默认 4，硬顶为 `min(本单元课数, 15, 宿主能力)`。Lead 参与实现时计入。
+- 只有写集不相交才允许并行。两个 L 子代理不得写同一文件。两个 miner 不得写同一 GP 文件。
+- 跨 mine unit 不得同时写课或同时挖掘。
+- 矩阵、chain、progress、verify、`lessons/INDEX` 只有 Lead 可写。
+- 矩阵冲突只暂停受影响格子；其他课的 T/M 继续。不得抢锁、清空或覆盖他人写集。
+
+## 无宿主 team 时的顺序回退
+
+宿主没有 任务执行者 / agent team：Lead 按相同派单包顺序执行，合同不变。禁止因为不能并行就退回 `L → mine → L → mine` 交错。阶段 T 结束之前禁止任何 miner 启动。
+
+## 计划会话
+
+G-goal `plan` / `replan` 允许 Lead 派只读库存员，以及在没有 `course.md` 时派 A 子代理。Lead 自己写 `goal/*` 骨架，并按 mine-unit 规则切单元。计划会话仍然禁止写 `lessons/` 与 `goal/probes/`。
+
+## HARD NO
+
+- 不在阶段 T 完成前启动 miner
+- 不交错 L 与 mine
+- miner 不得写 `lessons/` 或 matrix
+- miner 不得选择处置
+- 同一 mine unit 不得超过 15 节
+- 宿主没有 team 时，不得借机退回旧交错循环

package/template/workflows/learning/learning-g-goal/references/orchestration-protocol.md

@@ -0,0 +1,26 @@
+# G-goal 编排协议
+
+G-goal 只在 `plan` / `replan` 中编排上游地图。授课与挖掘由外部 `/goal` 按 Goal-Plan 派单。`/goal` 采用 lead-directed：Lead 扇出、写集隔离、mine unit ≤15。细节读 `<Path>{roots.workflows}/learning/learning-g-goal/references/lead-orchestration.md</Path>` 与 `<Path>{roots.workflows}/learning/learning-g-goal/references/mine-unit.md</Path>`。
+
+## 计划会话允许跟随的合同
+
+- `I-init-setup`：没有状态时写空骨架
+- `A-assess-and-plan`：写出或核对 `course.md`、background、baseline、sources、Change INDEX
+- 可选只读库存员：产出 C4 与函数分组，不写状态
+
+不得跟随：`L-lesson`、`Q-question`、`H-homework`、`R-review`、`C-consolidate`、`A-archive`。不得写 `lessons/` 或 `goal/probes/`。
+
+## `/goal` 会话允许跟随的合同
+
+- `L-lesson`：写 `lessons/L-*.md`（阶段 T，每课一个 writer）
+- `socratic-questioning` 且 `audience=mine`：写 `goal/probes/GP-*.md`（阶段 M，每课一个 miner）
+
+不得跟随：`Q-question` 的 `inquiry/` Response 协议、H/R/C/A-archive。
+
+## 所有权
+
+派单不是改写所有权。A 仍拥有 course 地图，L 仍拥有 lessons，G 拥有 `goal/`，Q 拥有 `inquiry/`。矩阵、chain、progress、verify、`lessons/INDEX` 只有 Lead 可写。
+
+## 并发
+
+Lead 扇出 + 写集隔离。只有写集不相交才允许并行。同一 mine unit ≤15 节。Wave 不是并发授权，也不是挖掘门。禁止「同一时间只推进一个 chain 节点」的旧交错循环；禁止因为宿主没有 team 就退回 `L → mine → L → mine`。

package/template/workflows/learning/learning-g-goal/references/planning-modes.md

@@ -0,0 +1,19 @@
+# G-goal 规划模式
+
+本文件只在激活 G-goal 后按模式读取。
+
+## plan（默认）
+
+写出完整 Goal-Plan、Chain、覆盖矩阵和进度骨架，并可跟随 A 合同写 `course.md` / background / baseline / sources。按库存切出 mine unit 列表（每个 ≤15 节，小项目允许远小于 15）。不写 `lessons/`，不写 `goal/probes/`，不提问学习者，不预写探针题目或深化讲义。`ready_for_execution: false`。计划正文不授权执行。
+
+## replan
+
+源码、范围或用户目标变化时重编译。旧 `goal-plan.md` 移入 `goal/revisions/REV-<NNN>.md` 只读。已写成且仍覆盖有效格子的 Lesson 不删除；失效格子改 `deferred` 或重新入链。mine unit 按新库存重切，仍硬顶 15。
+
+## run / resume
+
+不由本 Work 在激活会话内执行。执行器是用户的外部 `/goal`，合同见 `<Path>{roots.workflows}/learning/learning-g-goal/references/external-goal-runner.md</Path>` 与当前 `goal-plan.md` §5 / §8。运行形状是四段：P 已由计划会话完成；`/goal` 对每个 mine unit 走 T（写完全部课）→ M（按课提问）→ D（Lead 深化或拆课），再进入下一 unit。按项目切 unit，硬顶 15。
+
+## verify
+
+对照矩阵与 `verify.md` 验收。课写完不是完成。可由 `/goal` 在停止规则触发后执行；以后再激活 G-goal 时也可以只读验收，仍不得补写 Lesson 或 probe，除非用户明确改回 `replan` 或把计划交给 `/goal`。