improve
Use when the user asks to improve the harness, its rules, Guardian policy, skills or knowledge from experience on this machine, or says "remember this for next time", "make this a rule", "teach the harness".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- improve
- description
- Use when the user asks to improve the harness, its rules, Guardian policy, skills or knowledge from experience on this machine, or says "remember this for next time", "make this a rule", "teach the harness".
02 资源文件 1
- 其他.codex-harness6 B
03 SKILL.md 正文
Improve
Turn something learned into a durable change, in the right place, without leaking what must stay local.
Start
- Run
harness doctorand fix any FAIL first. - Read
overlay.tomlin the overlay ($CODEX_HARNESS_OVERLAY, in PowerShell$env:CODEX_HARNESS_OVERLAY, or the path the user gives).core_writabledecides where you may write.
Where changes go
| Change | Slot |
|---|---|
| A rule every session should follow | AGENTS.overlay.md |
| Something Guardian should treat as riskier or safer | guardian-policy.md (additions to the upstream policy, never a replacement) |
| A model for a tier | profiles.toml |
| A command rule | rules/<name>.rules. Prefer forbidden rules. An allow rule runs the command outside the sandbox with no review, and the agent can change what a test or build command runs, so allow only what you would run unsupervised in that repo. |
| A repeatable workflow | skills/<name>/SKILL.md, then run the skill-validate skill on it |
| A fact about tools, services or conventions here | knowledge/<slug>.md, one fact per file, plus one line in knowledge/INDEX.md |
With core_writable = false, write only to these overlay slots. Never edit the core checkout. With core_writable = true (a bench machine), core edits are allowed, with tests, and are committed in the core repo.
Knowledge
- One fact per file: what is true, why it matters, how to apply it.
- Before adding, search the index for a file that already covers it, and update that file instead.
- Keep
INDEX.mdat 150 lines or fewer, one line each. Merge related facts. When a fact is no longer true, name the file to the user and delete it only after they agree.
Finish
- Run
harness install, thenharness doctor. - Summarise what changed and where.
- End with Upstream candidates: improvements that would help anyone, written in generic language. Leave out company and product names, hosts, people, numbers measured at work, and code copied from work. The user decides whether to restate them on another machine. Nothing is copied across.
04 同仓库更多 Skills
web-consensus
Use when a question has to be settled against the live web rather than from memory - researching a topic, proving or disproving a claim, checking whether something is still true, a sourced second opinion on a factual question - or when the user says "research", "prove it", "with sources", "check if this is true", "still accurate?".
skill-validate
Use when a SKILL.md is about to ship or was just edited, when a skill is reviewed or audited, when a skill seems ignored, skipped or misread by agents, or when the user says "validate this skill", "lint the skill", "check my skill", "is this skill any good".
regression-tests
Use when fixing a bug, changing behaviour or adding a feature in code that has tests, or when the user asks whether a change is covered by tests, wants regression tests, or wants coverage of the changed lines.
redacao
Use when writing, rewriting or editing a technical article or blog post in Portuguese, or when the user says "escreve um artigo", "reescreve o post", "redação", "pauta", "revisa o texto", "tira a cara de IA".
hld-trace
Use when the user asks whether the code follows the high-level design (HLD), which requirements have tests, which are untested, or wants tests linked to requirement or work item IDs.
grilling
Use when the user wants a plan, decision, design or idea stress-tested before committing to it, or says "grill me", "grill this", "stress-test this", "poke holes in this", "what am I missing". Do not fire on your own.