SkillOpt-Sleep 是为本地 Claude 智能体设计的用量驱动自进化工具，把短期经验转化为长期能力。用途：让智能体从用户的实际使用中学习、跨会话记住偏好、按夜间计划或按需执行离线自我改进/做梦周期、回顾历史会话并提炼重复任务、把反馈整合进 CLAUDE.md 或受管技能，以及安排周期或采纳分阶段提案。
周期分六阶段：Harvest 只读读取 ~/.claude/projects/*/<session>.jsonl 与 ~/.claude/history.jsonl 生成会话摘要；Mine 摘要转为 TaskRecords；Replay 在当前技能与记忆下用所选后端重跑任务并给出硬/软评分；Consolidate 反思失败、提出有界编辑，并在留出切片上验证，默认仅接受严格提升的改动；Stage 把接受的 proposed_CLAUDE.md 与/或 proposed_SKILL.md、report.md、report.json、manifest.json、diagnostics.json 写入 <project>/.skillopt-sleep/staging/<timestamp>/，不改动实盘文件；Adopt 显式或经用户请求的 --auto-adopt 才复制并先备份。
用法优先使用 /skillopt-sleep 命令，其内部调用脚本：status 查看状态；dry-run --project "$(pwd)" 预览；run --project "$(pwd)" 跑完整周期并暂存提案；adopt --project "$(pwd)" 应用已暂存提案（含备份）。默认后端 mock，确定性、无 API 花费，适合试通流程；加 --backend claude 或 codex 等会消耗真实预算。常见参数包括 --scope all|invoked、--model、--source、--lookback-hours（默认72）、--max-sessions、--max-tasks（默认40）、--target-skill-path、--tasks-file、--auto-adopt、--edit-budget（默认4）、--preferences、--json。调度用 schedule --project "$(pwd)" --hour 3 --minute 17 安装夜间 cron，unschedule 或 unschedule --all 移除。配置在 ~/.skillopt-sleep/config.json，含 preferences、gate_mode、gate_metric、gate_no_regression、dream_rollouts、recall_k、evolve_memory、evolve_skill。
限制与注意：真实后端会把截断的转录与任务内容发送给所选提供商，Claude 转录路径不保证移除所有密钥，敏感数据应改用 mock 或先经 harvest --output <file> 审查脱敏并置 reviewed: true 后用 --tasks-file 重跑；真实后端拒绝未审查的任务文件。留出集增益只是本次运行的证据，不保证更广泛提升。采纳前应向用户展示留出基线到候选的分数变化与具体提案。不要手工编辑用户的 CLAUDE.md / SKILL.md，应走 adopt 或用户请求的 --auto-adopt 路径。无提供商调用时可运行 python -m skillopt_sleep.experiments.run_experiment --persona researcher --json 做合成演示。