Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

skill-evolution

/skill-evolution

Obsługuje cykl samoewolucji coco: 30-dniową pętlę, która obserwuje użycie skilli i proponuje poprawki w jednym branchu i pull requeście, bez zmian bez zgody właściciela.

Repozytorium
coco ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/ledger.py

Co robi i kiedy

Obsługuje cykl samoewolucji coco: 30-dniową pętlę, która obserwuje użycie skilli i proponuje poprawki w jednym branchu i pull requeście, bez zmian bez zgody właściciela.

Oryginalny opis (EN)

Use when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one branch and one pull request, and lands nothing without the owner's merge. Also use when asked why a skill changed, what the loop would propose next, or how to reject a proposal so it is not raised again.

Jak działa

  1. The one rule
  2. What a cycle does
  3. What the guard refuses
  4. Exit codes
  5. Cost
  6. Where things live
  7. Testing
  8. Changing this skill
Sekcje z nagłówków SKILL.md, w oryginale · 92 linii, 744 słów
Podgląd SKILL.md
---
name: skill-evolution
description: "Use when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one branch and one pull request, and lands nothing without the owner's merge. Also use when asked why a skill changed, what the loop would propose next, or how to reject a proposal so it is not raised again."
domain: meta
---

# Skill Evolution

A cycle that improves this repository's own skills from observed use, and proposes every
change for a human to merge. It never writes to `main` and never merges.

**Status:** the scripts this file documents, `scripts/evolve.py` and the steps it runs, are
not on `main` yet, so the commands below do not run today. They land with plan tasks 2 to 9
in `.metagpt/plan.md`: task 2 `ledger.py` through task 8 `evolve.py`, and task 9
`run_fixtures.sh` with the CI join.

## The one rule

**The loop proposes. The owner decides.** There is no confidence level, budget or green gate
that lets it land a change on its own. This is a design invariant, not a setting: a system
that edits the repository that measures it has no natural stopping point.

## What a cycle does

Five steps, and only the second one calls a model.

| Step | Script | Model? | Output |
| --- | --- | --- | --- |
| 1. Observe | `scripts/observe.py` | no | `signals/<cycle>.json`, pinned to one commit |
| 2. Propose | `scripts/propose.py` | yes, one lane | `proposals/<id>.json` and `proposals/<id>.patch` |
| 3. Validate | `scripts/validate.py` | no | accept or refuse, with a reason |
| 4. Open | `scripts/evolve.py` | no | one branch, one pull request |
| 5. Record | `scripts/ledger.py` | no | a ledger row per event, and `CYCLE.md` |

Run it:

```
python3 scripts/evolve.py run --window 30d            # the real cycle, needs credentials
python3 scripts/evolve.py run --window 30d --dry-run   # stops before opening a branch
python3 scripts/evolve.py run --window 30d --lane stub # no network at all
python3 scripts/evolve.py status                       # last cycle, open proposals
```

## What the guard refuses

`validate.py` is the only thing standing between a model's output and a branch. It refuses,
with the reason named, when any of these hold:

- **Out of scope.** v1 may change a skill's `description` frontmatter, its `references/` and
  its `SKILL.md` prose, and may add or remove example blocks. A persona file, a command file,
  a count file, a workflow or this skill's own scripts are all out of bounds.
- **An unresolvable citation.** Every proposal cites its evidence by file and line, or by
  receipt id, and the citation must resolve at the pinned commit.
- **Over a cap.** Proposals per cycle and diff size per proposal are both capped in
  `references/lanes.json`. A cycle that hits the cap states the remainder rather than
  truncating silently.
- **Already rejected.** A diff whose hash a ledger row rejected inside the two cycle window
  is not proposed again.
- **A count that moved alone.** If a proposal changes a published number, the coupled files
  must move with it, checked by running the repository's own checkers rather than a private
  copy of their rules. See `docs/rules.md` R7.

## Exit codes

Three valued, like every gate in this repository: **0** pass, **1** blocked by a guard,
**2** unrunnable or unmeasured. An empty cycle is exit 0 with nothing to propose, which is a
valid result and not a failure.

## Cost

Every model call goes through `scripts/lane.py`, which reads `references/lanes.json`, checks
the cycle budget **before** spending, obeys the model routing policy, and records the lane id
and token count on the proposal it produced. The expensive review lane refuses unless the
owner has explicitly authorised it for that cycle.

## Where things live

- `references/lanes.json` - the allowed lanes and their budgets.
- `references/proposal-schema.json` - the proposal shape, and the only fields a proposal may carry.
- `references/signal-sources.md` - what `observe.py` reads and what it deliberately does not.
- `state/ledger.jsonl` - the committed ledger. Append only. One record per event, and the
  record of why something was rejected is the part that matters.
- `state/CYCLE.md` - the rendered human artifact for the most recent cycle.

## Testing

`bash scripts/run_fixtures.sh` runs every suite and prints `N/N passed`. Every case uses the
stub lane, so the suite needs no network and no model. CI runs the same command, so a
proposal pipeline that stops working fails the build rather than shipping quietly.

## Changing this skill

Changing the loop's own scripts is out of scope for a loop proposal by design, which means a
change here is an ordinary pull request from a human or an agent working under review. If a
change alters a rule in this file, say so in the PR title and update `docs/rules.md` in the
same commit.
Pliki w paczce (8)
  • SKILL.md 5 KB
  • references/lanes.json 3 KB
  • references/proposal-schema.json 4 KB
  • references/signal-sources.md 3 KB
  • scripts/ledger.py 15 KB
  • scripts/fixtures/ledger/chain.jsonl 2 KB
  • scripts/fixtures/ledger/malformed.jsonl 1 KB
  • state/README.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · coco-research/coco100MIT
Lin-Yu-kuan/mySkill100MIT
Sirius-Ji/dsh-disciplinary-skills-for-greenhands100MIT
beita6969/scienceclaw100MIT
echoleesong/claude-skills-plugin100MIT

Migawka bazy z 13.11.2026 · wersja paczki 89b30b7da52a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100coco-loop
    Uruchamia bezpieczną, nadzorowaną pętlę autonomiczną z celu opisanego prostym językiem: tworzy czytelną kartę do potwierdzenia, proponuje poprawki i nigdy sama nie zatwierdza zmian.
  • 100self-evolution
    Analizuje wykonaną już pracę i zapisuje wnioski: odchylenia od zakresu, powtarzające się błędy i luki w procesach.
  • 100evolution-loop
    Zamienia zweryfikowane sygnały po zakończeniu zadań, powtarzających się porażkach lub uwagach użytkownika w audytowalne, ograniczone propozycje ulepszeń agentów, skilli, pamięci i dokumentacji.
  • 100skill-evolution-engine
    Zarządza historią wersji skilli i zautomatyzowanymi cyklami ulepszeń, w tym wersjonowaniem i utrzymaniem skilli.
  • 95evolve
    Prowadzi opcjonalną samoewolucję: jedna klasa zaległości na alarm, osobna gałąź, oddzielny recenzent i pull request tylko w forku.
  • 98coco
    Przekazuje tańszym agentom pracochłonne zadania, takie jak research, przeglądanie stron, kod szablonowy i streszczenia, by oszczędzać limit.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.