clice-io

Build clice, on a box unless a local build is truly necessary. Optional args = build type (Debug | RelWithDebInfo, default RelWithDebInfo) and the caller's box id. Runs in a forked context; only the outcome returns.

Read before running the codex CLI (GPT-6 astra) — the additional reviewer of the pr skill's self-review, plan attacks, debugging, scoped implementation. Only when codex is logged in and has quota.

Read before editing anything under docs/, and for the end-of-branch docs sync — generated feature and config pages, the en↔zh translation checker, the pixi commands driving them.

Read before committing, opening a PR, or checking on an open one — commit and title format, the checks of every push, self-review, opening, watching CI and review threads.

Use in each watch round of an open PR — pulls its unresolved review threads, fixes them in the worktree, resolves them, and returns a compact summary.

Run the clice test suites, on a box unless a local run is truly necessary; also how to test on Windows. Optional args = suite (unit | cases | all, default all) build type (Debug | RelWithDebInfo, default RelWithDebInfo) and the box id the build ran on. Runs…

Read before upgrading xclang/LLVM (arg = the xclang version, e.g. 23.1.2.1), touching MODULE.bazel, .bazelrc, BUILD.bazel or bazel/, or regenerating modules/ — after a library bump, or when clice needs a header or macro it does not export.

Read before writing or modifying anything under tests/ or unittests/, or the tools' own tests — the case workflow, unit tests, hard rules and known pitfalls.

How kotatsu's tests are organized and written — levels (unit, system, integration), the module-first layout, dependency and trust rules, naming, zest checks, determinism. Read BEFORE writing, moving or reviewing any test.

kotatsu C++ coding conventions — redundancy elimination (the rule we care most about), file organization, macro.h isolation, dual-mode exception policy, template deduction and type-trait rules, naming, modern C++ preferences. Read BEFORE writing or modifying…

Build kotatsu. Optional arg = cmake preset (default `debug`; also coverage, relwithdebinfo, asan, ubsan, asan-ubsan, tsan, no-exceptions, no-exceptions-no-rtti). Runs in a forked context — compile output and mechanical fixes stay out of the main conversation;…

Run kotatsu test suites. Optional args = suite (ctest | integration | all, default all) and cmake preset for the ctest suites (default `debug`). Runs in a forked context — test output stays out of the main conversation; only a digest returns.

The full pipeline from "code is ready" to "ready to merge" — pre-push verification, three-way self-review, opening the PR, watching CI and review threads. Read BEFORE committing, opening a PR, or checking on an open one.

Drive the codex CLI (GPT-6 astra) as a delegate — debugging, test writing, scoped implementation. Not for reviews, which go to Opus subagents. Read BEFORE invoking codex.

Pull unresolved review threads of the current PR, apply the fixes in the worktree, resolve the threads, and return a compact summary. Runs inline; the digest script keeps the bot boilerplate out of the conversation.

Format all project source files (C++, Python, Lua, JS/TS, Markdown, JSON, TOML, YAML). Run before every commit.

Cut an xclang release <llvm version>.<revision> — full rebuild or repack, release.yml run on an exp branch, draft → publish, then published.yml publishes it everywhere. Use when asked to release, rebuild, repack or publish a new xclang revision.

Move xclang to a new LLVM release (e.g. 23.1.2 → 23.1.3 or 24.1.0) — pinned sources, patches re-checked, version-specific code, first release <new>.1. Use when asked to upgrade or follow a new LLVM version.

Add, update or drop a change to LLVM in xclang's patches/ (patches/NNNN-name/NNNN.patch + README.md), validate it, and track its upstream state. Use when a clang/lld/libc++ bug needs fixing in xclang's build.