AGENT SKILL

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

03 SKILL.md 正文

Improve

Turn something learned into a durable change, in the right place, without leaking what must stay local.

Start

  1. Run harness doctor and fix any FAIL first.
  2. Read overlay.toml in the overlay ($CODEX_HARNESS_OVERLAY, in PowerShell $env:CODEX_HARNESS_OVERLAY, or the path the user gives). core_writable decides 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.md at 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

  1. Run harness install, then harness doctor.
  2. Summarise what changed and where.
  3. 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

jeancarlos
jeancarlos/code-jig

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?".

★ 0
jeancarlos
jeancarlos/code-jig

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".

★ 0
jeancarlos
jeancarlos/code-jig

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.

★ 0
jeancarlos
jeancarlos/code-jig

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".

★ 0
jeancarlos
jeancarlos/code-jig

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.

★ 0
jeancarlos
jeancarlos/code-jig

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.

★ 0