菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Audit 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.
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.
| name | dotagent:release |
| description | 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. |
Corta release nova do dotagent.
validate skillmain limpo (no uncommitted)cargo login) se for publicarEnquanto pre-1.0: minor pode quebrar API. Avisar no CHANGELOG.
Em Cargo.toml raiz:
[workspace.package]
version = "X.Y.Z"
Todas as crates do workspace herdam via version.workspace = true. Não
edita Cargo.toml individual.
Adiciona entrada no topo de CHANGELOG.md:
## [X.Y.Z] - YYYY-MM-DD
### Added
- ...
### Changed
- ...
### Fixed
- ...
# Skill validate completa
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
git tag -a vX.Y.Z -m "release X.Y.Z"
# NÃO push (commit policy do Avelino) — usuário faz o push manual
A ordem é grafo de dependência: publicar primeiro o que ninguém depende.
# Nível 0 — sem deps internas
cargo publish -p dotagent-core
cargo publish -p dotagent-plugin
# Nível 1 — dependem do core
cargo publish -p dotagent-notify
cargo publish -p dotagent-scheduler
cargo publish -p dotagent-state
cargo publish -p dotagent-unit-gen
# Nível 2 — dependem de state
cargo publish -p dotagent-runner
# Nível 3 — CLI
cargo publish -p dotagent
# Plugins (independentes — só preflight e sink agora)
cargo publish -p dotagent-plugin-preflight-warp
cargo publish -p dotagent-plugin-preflight-cmd
cargo publish -p dotagent-plugin-sink-roam
cargo publish -p dotagent-plugin-sink-file
Crates.io tem rate limit: deixa ~30s entre publishes.
gh release create vX.Y.Z --notes-from-tag
dotagent antes das deps internas. cargo publish falha
com erro de "X.Y.Z not found".validate antes. Tag aponta pra build quebrada =
reverter no público.