菜单
Keep apps/docs in sync with merged product changes. On each run, audit recently merged PRs against docs content, update only drifted pages, regenerate API MDX when public exports/JSDoc drifted, verify with blume validate/check/build/audit, and open or update a docs/* PR — or report a clean no-op.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Voice, tone, and format for the public Codemap docs (`apps/docs`, built with Blume). Use when authoring or editing apps/docs prose — landing, guides, concepts, recipes, reference, generated API — or deciding headline grammar, benefit framing, peer framing, or anti-pitch wording.
Repo-wide docs framework — what `docs/`, `docs/plans/`, `docs/research/`, `.agents/`, or any other doc-bearing surface in this repo looks like, what lifecycle each doc follows, and how to keep cross-references intact when slimming or moving content. Use when authoring or editing any `docs/**`, `docs/plans/**`, `docs/research/**`, `.agents/rules/**`, `.agents/skills/**`, or any new doc-bearing folder. Defines the lifecycle types (Reference / Roadmap / Plan / Audit / Research), the existence test every doc must pass, the closing-state lifecycles (delete + lift; never "Slim & keep in plans/"), the substrate variants (single `audit.md` vs `audits/<topic>.md`; conditional `glossary.md`), the surface tiers (repo-wide / per-tooling-area), and the cross-reference preservation discipline (grep before slim; preserve rule numbers cited from source). The Tier-2 priming layer at `.agents/rules/docs-governance.md` cites this skill and extends with codemap-specific bits only.
Bring a branch to pristine, maximum production readiness without changing PR intent — spawn parallel Task subagents (never inline review), fix in-bounds findings, loop autonomously until clean or pass cap, then report once. Use after a tracer-bullet commit (lite), before PR is done (full), on "harden", "harden-pr", "pristine", "review until clean", "production-ready pass", or "harden-pr reconcile". Invoking this skill authorizes one harden commit at cycle end. NEVER stop mid-loop to ask about commits, babysit, or the next pass. NEVER redesign the feature or change observable runtime behavior.
The product north-star — four Codemap tenets (structural over semantic, predicate-as-API, local-first / agent-native surfaces, honest scope). Use when making a design, API, or architecture decision, evaluating a trade-off, justifying a feature, or writing/reviewing a docs/plans entry.
Delta-driven dependency upgrades — a script gathers the evidence, you read the artifact and judge. Use when the user asks to upgrade, bump, or CVE-audit dependencies.
Full tier assignments, pairing conventions, and authoring checklist for .agents/ rules and skills. Use when creating or reviewing a rule or skill, deciding Tier 1 vs 2 vs 3, or auditing attachment cost.
| name | update-docs |
| description | Keep apps/docs in sync with merged product changes. On each run, audit recently merged PRs against docs content, update only drifted pages, regenerate API MDX when public exports/JSDoc drifted, verify with blume validate/check/build/audit, and open or update a docs/* PR — or report a clean no-op. |
Upstream workflow: npx skills add haydenbleasel/blume --skill blume-update-docs. This local skill encodes it for scheduled agents in this repo.
git log --since="7 days ago" --merges --first-parent and gh pr list --state merged --search "merged:>$DATE". Done: every merged PR in the window listed with title, number, and surfaces touched.src/cli/, src/application/, src/adapters/, src/db.ts (createTables() / SCHEMA_VERSION), package.json exports, blume.config.ts / apps/docs/**, templates/recipes/*.{sql,md}, templates/agent-content/**, and TypeDoc-facing JSDoc to the pages that document them (content/reference/api/** generated, content/reference/** hand, content/guides/**, content/recipes/**, content/concepts/**, plus homepage _home/** when behavior framing changed). Regenerate API MDX via bun run docs:api when public exports/JSDoc drifted. Done: every changed public surface mapped to zero or more docs pages.docs-voice; do not rewrite stable prose. Peer framing stays code-index / agent-context tools only — never store/adapter middlewares. Done: every drifted fact updated; no stable prose touched.bun run docs:validate -- --strict && bun run docs:check -- --isolated && bun run docs:build && bun run docs:audit (run from apps/docs/ or via root docs:* scripts); fix until green. Do not commit if any fail. Per verify-after-each-step. Done: all four green.docs/sync-<date> with a summary of what drifted and the fixes. Label it docs so merge deploys /codemap via FTP (docs-governance/LIFECYCLE.md § README surfaces). Follow commit/PR conventions; never --no-verify (no-bypass-hooks). Changeset for a docs-only sync is patch (pre-1.0; schema-breaking is the only minor trigger). Done: PR open with docs label and drift summary, or step 7 applies.apps/docs/ (+ root scripts/config the docs app requires, e.g. typedoc.json when regenerating API) — never edit maintainer docs/ plans/research/audits in a sync PR; never edit library src/ in a docs-sync PR.authoring-discipline).verify-after-each-step · harden-pr (lite before commit, full before merge)authoring-disciplinedocs-voicedocs-governance (governs docs/ + apps/docs/ README surfaces; this skill governs apps/docs/ sync only)