Codex Autoresearch

Měřená, obnovitelná optimalizační smyčka s baseline, bránou správnosti a knihou důkazů

od TheGreenCedar · TheGreenCedar/codex-autoresearch

Otestováno · Funguje ★ 8.8/10

Codex Autoresearch — Měřená, obnovitelná optimalizační smyčka s baseline, bránou správnosti a knihou důkazů

Co umí

Přemění vágní požadavek "make it faster/smaller" na měřenou smyčku: zaznamenává benchmark baseline, spouští jednu cílenou změnu na paket, znovu spouští kontroly správnosti a loguje každý výsledek (metrika, rozhodnutí, důkaz, další akce) do obnovitelného souboru relace s cíleným git commitem. Spouští se na optimalizaci řízenou benchmarky (doba běhu testu, velikost balíčku, latence, paměť), kvalitativní výzkum mezer v kvalitě, obnovení existující autoresearch relace nebo přípravu finalizace review-branch. Podporováno Node CLI (autoresearch.mjs), které spouští benchmark a lokálně kontroluje příkazy.

Testovací report

Vytvořil jsem jednoduchý Node projekt (sumTo pomocí array+reduce, bench.mjs tisknoucí METRIC seconds= a checks.mjs), poté jsem spustil smyčku dvěma způsoby v dočasném HOME. Baseline (bez skillu): Pouze jsem přepsal funkci na akumulační smyčku a znovu spustil bench (0.7297s -> 0.3652s) — rychlejší soubor, žádný záznam. Skill: setup zapsal relaci (autoresearch.md/.jsonl/.sh), doctor --check-benchmark potvrdil METRIC kontrakt, next+log zachytil baseline 0.7234, poté keep packet zaznamenal 0.3542 s úspěšnými kontrolami (exit 0, "checks OK"), vytvořil cílený git commit 8d4e192 dotýkající se pouze lib/sum.mjs, připojil ASI poznámku (hypothesis/evidence/next-action) a finalize-preview vytvořil review-branch plán označující zralost "experimental". Rozhodující rozdíl: když jsem zadal rychlejší, ale chybnou změnu (closed-form +1), kontroly paketu skončily s kódem 1 a CLI vynutil stav checks_failed jako jediný povolený stav, odmítající zachování — cesta baseline nemá takovou regresní bránu.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

git clone --depth 1 https://github.com/TheGreenCedar/codex-autoresearch.git /tmp/codex-autoresearch-src
mkdir -p ~/.claude/skills
cp -R /tmp/codex-autoresearch-src/plugins/codex-autoresearch/skills/codex-autoresearch ~/.claude/skills/codex-autoresearch
# NOTE: this is a Codex PLUGIN, not a standalone skill. The SKILL.md drives a Node CLI that
# lives OUTSIDE the skill folder at /tmp/codex-autoresearch-src/plugins/codex-autoresearch/scripts/autoresearch.mjs
# Requirements: Node >= 24. On first run the CLI hydrates a runtime (downloads the matching
# GitHub release tarball with sha256 verification, or build locally from the clone).
# Run commands from the package root, e.g.:
#   node /tmp/codex-autoresearch-src/plugins/codex-autoresearch/scripts/autoresearch.mjs setup --cwd <project> --name <s> --metric-name seconds --direction lower --benchmark-command "<cmd printing METRIC name=value>" --checks-command "<cmd>"
# Intended install path is Codex's /plugins picker (TheGreenCedar -> codex-autoresearch), which bundles the CLI.

Příkazy a ukázkové prompty

/codex-autoresearchMěřená, obnovitelná optimalizační smyčka s baseline, bránou správnosti a knihou důkazů

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

Start a new Codex Autoresearch loop
Resume and inspect the current autoresearch run
Show the autoresearch dashboard and quality gaps

Kompletní testovací report (anglicky) →