comprehensive-learning 是一个会话后学习流水线技能，通过单条 fire-and-forget 命令依次执行阶段 1–9；阶段 10a（跨机器编译）和阶段 10（报告）仅在 dev-primary 上运行。完整阶段规范见 references/pipeline-detail.md，其中包含信号来源、提取规则、候选格式和状态文件细节。
用途与能力：阶段 1 Insights 从所有日志来源提取技能使用、工具模式、会话质量信号；1b Drift Detection 在 dev-primary 检测 python_runtime/file_placement/git_workflow 违规；2 Reflect 调用 /reflect；3 Knowledge 调用 /knowledge 并更新 patterns/；3b 记忆压缩；3c 记忆整理；4 Improve 调用 /improve，根据候选更新技能与规则；5 修正趋势分析；6 WRK 反馈与生态健康；7 将候选条目转为 WRK 项；8 报告复核；9 每周技能覆盖审计；10a 仅 full 模式执行 git pull 汇总所有机器数据；10 始终写报告。
使用方式：按顺序运行各阶段。非强制阶段失败仅记录并继续；阶段 1 或 4 出现致命失败会设置 _PIPELINE_EXIT=1；阶段 10 通过 trap EXIT 始终运行。模式路由通过 hostname 判断，dev-primary 为 full，其余为 contribute。跨机器数据按 candidates/、corrections/、patterns/、session-signals/ 等目录提交，dev-primary 在阶段 10a 用 git pull 获取。
限制与约定：会话期间不得单独运行 /insights、/reflect、/knowledge、/improve、consume-signals.sh 重型分析、ecosystem-health-check.sh、session-end-evaluate.sh 评分；学习一律推迟到夜间流水线。Stop hook 仅一个，仅原始写入，耗时小于 1 秒。
调度示例（dev-primary，每晚 22:00）：
0 22 * * * cd /mnt/local-analysis/workspace-hub &&
bash scripts/cron/comprehensive-learning-nightly.sh \
.Codex/state/learning-reports/cron.log 2>&1
其中 git pull 是硬性门槛，各 rsync 独立 || true。相关技能与项：workstations、WRK-299、WRK-304、WRK-305、WRK-303。