菜单
Run the full validation pipeline for dotagent (fmt, clippy with -D warnings, workspace tests, and end-to-end smoke test). Use before claiming a change is "done", before opening a PR, or when CI fails and the user wants to reproduce locally. Reports each step and stops at the first failure.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | dotagent:validate |
| description | Run the full validation pipeline for dotagent (fmt, clippy with -D warnings, workspace tests, and end-to-end smoke test). Use before claiming a change is "done", before opening a PR, or when CI fails and the user wants to reproduce locally. Reports each step and stops at the first failure. |
Pipeline de validação completa do dotagent. Roda em ordem e para na primeira falha.
cd $REPO_ROOT
cargo fmt --all -- --check
Se falhar:
cargo fmt --all # aplica
cargo clippy --workspace --all-targets -- -D warnings
CI é estrito (-D warnings). Warning = build broken.
cargo test --workspace --all-targets
Cobertura esperada (baseline):
dotagent-scheduler: ≥ 8 testes (expected_at, is_stale, should_retry, health_state, resolve_policy)dotagent-state: ≥ 2 testes (slug derivation, heartbeat roundtrip)cargo build --release -p dotagent -p dotagent-plugin-preflight-warp
DOTAGENT_ROOT=$PWD/examples ./target/release/dotagent doctor
DOTAGENT_ROOT=$PWD/examples ./target/release/dotagent run hello-fish --schedule manual --dry-run
DOTAGENT_ROOT=$PWD/examples ./target/release/dotagent run hello-fish --schedule manual # write heartbeat
cat ~/.local/state/dotagent/agents/hello-fish/default.heartbeat.json | jq '.exit_code' # should be 0
doctor deve listar 4 manifests ok. run deve emitir env vars no stdout do
fish e exit 0. Heartbeat tem exit_code: 0 e last_success_at preenchido.
./target/release/dotagent-plugin-preflight-warp info | jq -e '.kinds == ["preflight"]'
(Notifiers built-in não respondem info — vivem dentro do daemon; smoke
deles é via dotagent doctor que lista notifier driver=<x> (built-in).)
✓ cargo fmt — clean
✓ cargo clippy — 0 warnings
✓ cargo test — N passed, 0 failed
✓ doctor — 4 manifests ok, notifiers listed as built-in
✓ run hello-fish --dry-run — exit 0
✓ run hello-fish — heartbeat written, exit 0
✓ plugin info — preflight-warp respond
Se qualquer um falhar, não reporte "done" — fixa primeiro.
docs/**/*.md — só rode markdownlintcargo checkAudit dotagent docs for drift after ANY code/behavior change — new plugin, renamed field, moved file, changed default, new env var, new command, new event type, schema bump, path change. Always invoke before reporting a task as "done" if the change is user-visible. Returns a punch list of doc files that need updating with the specific lines/sections that are now stale, plus any links pointing to moved/renamed files. Never silently passes — when in doubt, flag.
Add a new subcommand to the `dotagent` CLI. Use when the user asks to "add a command", "expose X as CLI", "create dotagent subcommand", or any extension to the CLI surface. Handles clap enum entry + commands/ implementation + help text consistency.
Scaffold a new dotagent plugin (notify/preflight/sink). Use when the user asks to "add a plugin", "create a plugin for X", "support Pushover/Discord/Telegram/etc", or any new external integration. The skill produces a complete plugin crate that obeys the info/validate/invoke protocol and registers it in the workspace.
Migrate an agent from the Fish-based `lib/agent.fish` framework (in avelino/dotfiles) to dotagent. Use when the user says "porta X pro dotagent", "migra Y", "transforma meta.json em agent.toml". Produces a working agent.toml that points at the existing agent.fish without rewriting it.
Cut a new release of dotagent. Use when the user says "release X.Y.Z", "tag a release", "publish to crates.io". Handles version bump in workspace.package.version, CHANGELOG, git tag, and the cargo publish order across the workspace dependency graph.