176 lines
7.4 KiB
Markdown
176 lines
7.4 KiB
Markdown
# Changelog
|
|
|
|
All notable changes to this skill are documented here, including anything an
|
|
agent or user must do when upgrading. Format follows
|
|
[Keep a Changelog](https://keepachangelog.com/); versions follow
|
|
[SemVer](https://semver.org/) and match `version` in `SKILL.md` frontmatter.
|
|
|
|
Read this before upgrading. General upgrade rules:
|
|
|
|
- **OpenClaw hook changes only take effect after re-copying and restarting.**
|
|
The hook runs from a copy: re-run
|
|
`cp -r ~/.openclaw/skills/self-improving-agent/hooks/openclaw ~/.openclaw/hooks/self-improvement`
|
|
and restart the gateway after upgrading.
|
|
- `.learnings/` files are user data and are never migrated or overwritten by
|
|
upgrades; first-use initialisation is idempotent and only creates missing
|
|
files.
|
|
|
|
## [Unreleased]
|
|
|
|
## [4.0.2] - 2026-08-06
|
|
|
|
> 4.0.1 is skipped: that version number was already used by a build
|
|
> published to ClawHub, so it is not reusable here.
|
|
|
|
### Fixed
|
|
|
|
- **Install commands and clone URL in the docs were wrong** (#24). The
|
|
advertised `clawdhub install` command does not exist. The documented
|
|
commands are now `openclaw skills install @pskoett/self-improving-agent`
|
|
(built-in, installs into the active workspace) and
|
|
`clawhub install @pskoett/self-improving-agent` (ClawHub CLI,
|
|
`npm i -g clawhub`, installs into `./skills` under the current working
|
|
directory). Both take the `@owner/slug` form — a bare slug is only
|
|
accepted for already-installed or unambiguous skills. Fixed in
|
|
`README.md`, `SKILL.md`, and `references/openclaw-integration.md`.
|
|
- The manual `git clone` URL used the wrong owner handle
|
|
(`peterskoett` → `pskoett`). The old handle only resolved via a web
|
|
redirect, which `git clone` does not follow, so manual installs failed on
|
|
a fresh machine.
|
|
|
|
### Added
|
|
|
|
- GitHub Actions CI (`.github/workflows/ci.yml` at the repo root): runs the
|
|
hook test suite, type-checks `handler.ts` (strict mode, against a CI-only
|
|
type stub), and syntax-checks `extract-skill.sh` on every push to master
|
|
and every PR.
|
|
|
|
### Changed
|
|
|
|
- **Repo restructured for ClawHub publishing**: the skill package now lives
|
|
in the repo's `self-improving-agent/` subfolder (SKILL.md, assets, hooks,
|
|
references, scripts, this changelog), keeping repo-level files (README,
|
|
`.github/`) out of the published skill. Install by copying the subfolder,
|
|
not the repo root — install/upgrade commands in the docs are updated.
|
|
- `SKILL.md` frontmatter `name` corrected from `self-improvement` to
|
|
`self-improving-agent` to match the skill folder name, as the Agent Skills
|
|
spec requires. The OpenClaw *hook* keeps its `self-improvement` name, so
|
|
existing hook installs and `openclaw hooks enable self-improvement` are
|
|
unaffected.
|
|
|
|
### Upgrade notes (4.0.x → 4.0.2)
|
|
|
|
Documentation only — no skill behavior, hook, or `.learnings/` changes. No
|
|
action needed beyond reinstalling if you want the corrected install docs.
|
|
|
|
## [4.0.0] - 2026-07-04
|
|
|
|
### Removed
|
|
|
|
- **This distribution is now OpenClaw-only.** Removed the Claude Code /
|
|
Codex / Copilot integrations: `scripts/activator.sh`,
|
|
`scripts/error-detector.sh`, `references/hooks-setup.md`, and the
|
|
multi-agent setup/support sections in `SKILL.md` and
|
|
`references/uninstall.md`. For other agents, use the original multi-agent
|
|
version: https://github.com/pskoett/pskoett-ai-skills.
|
|
|
|
### Changed
|
|
|
|
- Promotion targets are now the OpenClaw workspace files (`SOUL.md`,
|
|
`TOOLS.md`, `AGENTS.md`), with the project's own agent file as the target
|
|
for project-specific patterns.
|
|
- Hook docs and code comments describe the session-end sweep on its own
|
|
terms (OpenClaw has no per-tool-call event) instead of contrasting with
|
|
other platforms.
|
|
|
|
### Upgrade notes (0.3.0 → 4.0.0)
|
|
|
|
1. If you configured the Claude Code/Codex hooks from earlier versions,
|
|
remove the stale `.claude/settings.json` / `.codex/settings.json` entries
|
|
pointing at `activator.sh` / `error-detector.sh`, and switch to the
|
|
original multi-agent skill for those platforms.
|
|
2. Nothing changes for OpenClaw installs beyond the usual re-copy of the
|
|
hook directory; `.learnings/` data and entry formats are unaffected.
|
|
|
|
## [0.3.0] - 2026-07-04
|
|
|
|
### Added
|
|
|
|
- **Pattern-Key generalized to all three log files**: the `ERRORS.md` and
|
|
`FEATURE_REQUESTS.md` entry formats now carry a `Pattern-Key` field
|
|
(recommended for errors, optional for features), joining `LEARNINGS.md`
|
|
where it was previously limited to the simplify-and-harden feed.
|
|
- **Pattern-Key Taxonomy** section in `SKILL.md`: controlled `area.symptom`
|
|
namespaces (`api`, `auth`, `build`, `config`, `deps`, `fs`, `net`,
|
|
`runtime`, `shell`, `vcs`, plus `simplify`/`harden`), with reuse-before-mint
|
|
and one-key-per-entry rules.
|
|
- The OpenClaw session-end error sweep stamps deterministic `Pattern-Key`
|
|
values on auto-detected entries (e.g. `ModuleNotFoundError` →
|
|
`deps.module-not-found`), making them recurrence-countable with no agent
|
|
discipline required.
|
|
|
|
### Changed
|
|
|
|
- Grep-by-`Pattern-Key` is now the documented **default dedup step** when
|
|
logging; keyword grep is the fallback. Recurrences are folded into the
|
|
existing entry (`Recurrence-Count`, `Last-Seen`, `See Also`) instead of
|
|
duplicated.
|
|
- Tightened `SKILL.md` (hook sections, taxonomy, duplicated setup blocks) to
|
|
keep the always-loaded skill prompt compact.
|
|
|
|
### Fixed
|
|
|
|
- `scripts/extract-skill.sh` is now committed with the executable bit set —
|
|
previously every install needed a manual `chmod +x`.
|
|
|
|
### Upgrade notes (0.2.0 → 0.3.0)
|
|
|
|
1. Re-copy the OpenClaw hook and restart the gateway (see general rules
|
|
above) to get Pattern-Key stamping on swept entries.
|
|
2. Existing `.learnings/` entries without `Pattern-Key` remain valid — the
|
|
field is additive. Add keys opportunistically when touching old entries.
|
|
|
|
## [0.2.0] - 2026-07-04
|
|
|
|
### Added
|
|
|
|
- **OpenClaw session-end error sweep** (`hooks/openclaw/`): the hook now also
|
|
fires on `command:new` / `command:reset`, scans the ended session's
|
|
transcript for the same error patterns as `scripts/error-detector.sh`, and
|
|
appends pending entries (`Source: openclaw-error-sweep`) to
|
|
`<workspace>/.learnings/ERRORS.md`. Opt-in: runs only when
|
|
`<workspace>/.learnings/` exists. Excerpts are capped, truncated, redacted,
|
|
and deduplicated.
|
|
- Pending-triage note in the bootstrap reminder when auto-detected error
|
|
entries await review.
|
|
- Test suite: `node --test hooks/openclaw/handler.test.js` (no dependencies).
|
|
- Docs: "Error Detection on OpenClaw" section and platform support matrix in
|
|
`references/openclaw-integration.md`; uninstall guide in
|
|
`references/uninstall.md`; this changelog.
|
|
|
|
### Changed
|
|
|
|
- `hooks/openclaw/HOOK.md` events metadata is now
|
|
`["agent:bootstrap", "command:new", "command:reset"]`.
|
|
- Docs now state explicitly that `scripts/error-detector.sh` is Claude Code
|
|
only (OpenClaw has no `PostToolUse` equivalent).
|
|
|
|
### Upgrade notes (0.1.x → 0.2.0)
|
|
|
|
1. Re-copy the hook and restart the gateway (see general rules above).
|
|
2. To enable the new error sweep: `mkdir -p ~/.openclaw/workspace/.learnings`.
|
|
Without that directory, behavior is identical to 0.1.0.
|
|
3. No breaking changes; no `.learnings/` migration needed.
|
|
|
|
## [0.1.0] - 2026-01-31
|
|
|
|
### Added
|
|
|
|
- Initial release: `SKILL.md` with logging formats (`LEARNINGS.md`,
|
|
`ERRORS.md`, `FEATURE_REQUESTS.md`), promotion workflow, and skill
|
|
extraction.
|
|
- OpenClaw bootstrap-reminder hook (`agent:bootstrap`).
|
|
- Claude Code hook scripts: `activator.sh` (UserPromptSubmit) and
|
|
`error-detector.sh` (PostToolUse).
|
|
- Reference guides for hooks setup and OpenClaw integration.
|