mirror of https://github.com/microsoft/SkillOpt.git synced 2026-07-06 16:05:12 +08:00

Files

Yifan Yang f9db99853b feat(plugins): ship SkillOpt-Sleep for Claude Code, Codex, and Copilot

Restructure into plugins/{claude-code,codex,copilot}/ — one engine, three thin
shells, all calling the shared plugins/run-sleep.sh -> python -m skillopt_sleep.

  - claude-code/: existing plugin moved here; runner delegates to the shared
    launcher (fixes repo-root resolution after the move).
  - codex/: ~/.codex/prompts/sleep.md custom prompt + ~/.agents/skills SKILL.md +
    install.sh + AGENTS.md hint — Codex's documented, stable extension surfaces.
  - copilot/: a stdlib-only MCP server (mcp_server.py) exposing sleep_* tools,
    plus mcp-config.example.json and a copilot-instructions snippet. Verified end
    to end (initialize -> tools/list -> tools/call returns real engine output).
  - plugins/README.md overview table; main README News + a dedicated SkillOpt-Sleep
    section; pyproject lists skillopt_sleep as a first-class package.

Decoupling emphasized throughout: open-source tool (skillopt_sleep/) with zero
dependency on the research package. 29 tests pass; all three shells resolve.

Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>

2026-06-08 14:31:52 +00:00

2.9 KiB

Raw Blame History

description, argument-hint, allowed-tools

description	argument-hint	allowed-tools
Run or manage the SkillOpt-Sleep self-evolution cycle (review past sessions, replay tasks offline, consolidate validated memory + skills)	[run \| dry-run \| status \| adopt \| harvest] (default: status)	Bash, Read

/sleep — SkillOpt-Sleep nightly self-evolution

You are driving SkillOpt-Sleep: a tool that lets this user's Claude agent improve offline by reviewing past sessions, replaying recurring tasks, and consolidating what it learns into validated memory (CLAUDE.md) and skills (SKILL.md). It is gated like SkillOpt: a change is kept only if it improves a held-out replay score, and nothing live is modified until the user adopts it.

Requested action: $ARGUMENTS

(If $ARGUMENTS is empty, treat it as status.)

How to run it

The engine is the skillopt_sleep Python package in this repo. Use the plugin's bundled runner so the right interpreter and repo are on the path:

"${CLAUDE_PLUGIN_ROOT}/scripts/sleep.sh" <action> --project "$(pwd)" --scope invoked

<action> is one of:

action	what it does
`status`	show how many nights have run + the latest staged proposal (READ-ONLY)
`dry-run`	harvest → mine → replay → report, but stage nothing (safe preview)
`run`	full cycle: also stage a reviewed proposal (still does NOT touch live files)
`adopt`	apply the latest staged proposal to live `CLAUDE.md` / `SKILL.md` (backs up first)
`harvest`	debug: print the recurring tasks mined from recent sessions

Default backend is mock (deterministic, no API spend). To use real Anthropic budget for genuine improvement, add --backend anthropic.

Steps to follow

Run the requested action via the bundled runner above. Capture stdout.
For run / dry-run: after it completes, Read the generated report.md in the staging dir it prints, and show the user:
- held-out score: baseline → candidate (the proof it helped)
- the gate decision (accept/reject) and the exact edits it proposes
- where the proposal is staged
For run that produced an accepted proposal: tell the user the diff is staged and that nothing live changed yet. Offer to run /sleep adopt.
For adopt: confirm which live files were updated and that backups were written under the staging dir's backup/.
Never edit CLAUDE.md or SKILL.md yourself — only the adopt action does that, with a backup. Respect the review gate.

Safety reminders

Harvest is read-only over ~/.claude. Replay in mock mode runs no shell side effects.
The cycle stages proposals; the user is in control of adoption.
If the user asks to schedule this nightly, point them at ${CLAUDE_PLUGIN_ROOT}/scripts/install-cron.sh (prints a crontab line; does not install anything without confirmation).

2.9 KiB Raw Blame History