auto: sync OpenClaw config 2026-09-16 16:13

2026-09-16 16:13:36 +08:00
parent c51006a57d
commit 5ac4289f66
35 changed files with 4827 additions and 65 deletions
@@ -0,0 +1,175 @@
+# 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.