codex-vdd-skills

Browser-reviewable L1 acceptance-spec planning for non-trivial code or data changes. Use when the operator asks for planboard, a plan they can annotate in the browser, or a spec of "what must be true and how we verify it" before code. The Orchestrator runs a GQM intent interview, elicits requirements each fused to an acceptance gate, hardens every gate with a mutation-style attack via Codex sub-agents, then renders an annotatable HTML spec. Do not use for trivial one-file edits, quick questions, or research/docs tasks whose success has no writable verifier.

Verifier-Driven Development (VDD) workflow for non-trivial implementation, rewrite, refactor, simplification, data-pipeline, exporter, adapter, prompt, UI preview, training-format work, failure investigation, review feedback, and completion claims. Use when Codex needs to turn operator intent into explicit contracts, mocks, code verifiers, sub-agent verifier passes, and layered validation before, during, or after code changes.

检查和清理中英文文本里的 AI 套路，适用于“去 AI 味”“说人话”“自然一点”“别像模板”“先标问题”这类改写和审稿需求；按场景控制力度，同时保留事实、术语、语域和责任主体。

At session wrap-up, read the session and the docs and propose a short list of changes — what to ADD (things the human flagged out loud), what to RETIRE (now stale or duplicated), and what has earned a guardrail (PROMOTE to a hook, lint, or code structure). The Curator judges and proposes; the human accepts or rejects; the Librarian applies the survivors. It never reorganizes or deletes unattended.

Apply the doc changes the human accepted and keep the documentation findable — relocate prose into the right doc, maintain docs/README.md as the index, write the pointers and hooks that make a doc reach an agent at the right moment, and apply small accepted lints. Runs after the Curator. It organizes and wires; it never judges what's worth keeping (the Curator's job) and never loses information.

End-of-session documentation reconcile. Runs the Curator to propose a short ADD/RETIRE/PROMOTE list, waits for the human to accept or reject, then runs the Librarian to apply only the survivors. Invoke as /wrap when finishing a working session. User-invoked; never auto-run.