Skip to main content 首页 创作者 akillness oh-my-skills changelog-maintenance
changelog-maintenance Write and maintain release-history artifacts for shipped changes: `CHANGELOG.md` updates, release notes, migration/deprecation updates, and lightweight game patch notes. Use when the main job is turning shipped evidence into the smallest truthful release-writing packet for developers, customers, internal stakeholders, or players. Triggers on: changelog, release notes, patch notes, migration update, deprecation notice, version notes, what shipped, what changed, and what's new. Route internal specs/runbooks to `technical-writing`, API portals to `api-documentation`, end-user tutorials to `user-guide-writing`, rollout execution to `deployment-automation`, and launch messaging to `marketing-automation`.
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/akillness/oh-my-skills --skill changelog-maintenance命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... One-shot installer for the akillness/oh-my-gods agent skill bundle (80+ skills spanning agent-browser, agent-workflow, ai-research-skills, api-design, and the full god-skills catalog). Use when the user asks to add the oh-my-gods skill pack, bring in the AgenticSkills bundle, or wants every god-skill copied into Claude Code, Codex CLI, Antigravity/Gemini, and OpenCode in one step. Triggers on: AgenticSkills, agenticskills, oh-my-gods, god-skills, install oh-my-gods, bring in agentic skills bundle, install gods skills, add god skills.
Make any software agent-native with HKUDS CLI-Anything — route between four modes: install ready-made CLI harnesses via the CLI-Hub package manager (`pip install cli-anything-hub`, then `cli-hub list/search/info/install/launch`), give agents the autonomous discovery meta-skill (`npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill`), generate a new harness from any codebase or GitHub repo via the 7-phase pipeline (`/plugin install cli-anything` → `/cli-anything <path>`), or iterate with `/cli-anything:refine`, `:test`, `:validate`. 40+ production harnesses (GIMP, Blender, LibreOffice, OBS, ComfyUI, Ollama, Godot, QGIS, …), 2,461 passing tests, Click CLIs with REPL + `--json` output. Use when agents must drive real desktop/server software without GUI automation. Triggers on: cli-anything, cli-hub, cli-anything-hub, agent-native cli, make software agent-native, cli harness generation, /cli-anything, harness refine, HKUDS cli.
Run Comet's Opik — open-source LLM observability, evaluation, and optimization — from one routing-first skill: install the Python/TypeScript SDK, stand up a server (Comet.com cloud, Docker Compose via `./opik.sh`, or Kubernetes/Helm), wire tracing through `@opik.track` or one of 50+ framework integrations (OpenAI, Anthropic, LangChain, LangGraph, LlamaIndex, CrewAI, DSPy, Ollama, Bedrock, Vercel AI SDK, …), score outputs with LLM-as-a-judge metrics (Hallucination, Moderation, Answer Relevance, Context Precision), and run Datasets/Experiments evaluations including PyTest CI gates. Use when the user wants LLM tracing, prompt evaluation, production LLM monitoring, agent optimization, or guardrails with Opik. Triggers on: opik, comet opik, opik configure, opik.sh, llm observability, llm tracing, llm as a judge, hallucination metric, prompt evaluation, opik dashboard, opik guardrails, agent optimizer.
name changelog-maintenance description Write and maintain release-history artifacts for shipped changes: `CHANGELOG.md` updates, release notes, migration/deprecation updates, and lightweight game patch notes. Use when the main job is turning shipped evidence into the smallest truthful release-writing packet for developers, customers, internal stakeholders, or players. Triggers on: changelog, release notes, patch notes, migration update, deprecation notice, version notes, what shipped, what changed, and what's new. Route internal specs/runbooks to `technical-writing`, API portals to `api-documentation`, end-user tutorials to `user-guide-writing`, rollout execution to `deployment-automation`, and launch messaging to `marketing-automation`. allowed-tools Read Write Edit Glob Grep compatibility Best for docs-as-code repositories, GitHub/GitLab release workflows, changeset / release-PR automation, customer-update hubs, and game patch-note surfaces where the output lives in Markdown, release entries, docs sites, in-product feeds, or store announcements.
license MIT metadata {"tags":"changelog, release-notes, patch-notes, migration, semantic-versioning, documentation, release-communication","platforms":"Claude, ChatGPT, Gemini","version":"2.1.0","modernization":"2026-04-14T00:00:00.000Z","hardening":"2026-04-18T00:00:00.000Z"}
Changelog Maintenance
Use this skill when the deliverable is release history or shipped-change communication , not a broad documentation or launch-campaign bundle.
changelog-maintenance is the documentation-cluster anchor for:
CHANGELOG.md upkeepGitHub / GitLab / docs-site release notes
migration and deprecation updates tied to a shipped change
customer-facing “what changed” summaries
lightweight game patch notes and small update posts
Read these support docs before choosing the mode or boundary:
When to use this skill
A repo needs a durable changelog entry or Unreleased refresh based on shipped work
A release needs audience-appropriate notes for developers, customers, internal stakeholders, or players
A breaking change, deprecation, or compatibility shift needs a migration update linked from release history
Release automation drafted notes, but the output still needs truthful grouping, clearer wording, or better route-outs
A game update needs concise patch notes without collapsing into marketing copy, deployment runbooks, or full help docs
The real job is deciding the smallest release-writing packet rather than writing every neighboring document from scratch
When not to use this skill
The main job is an internal spec, runbook, ADR, rollout plan, or deep migration procedure → technical-writingThe main job is published API / SDK / webhook / developer-portal content → api-documentationThe main job is end-user onboarding, tutorials, screenshots, FAQs, or help-center walkthroughs → user-guide-writingThe main job is deployment execution, environment promotion, rollback mechanics, or release orchestration → deployment-automationThe main job is launch copy, feature positioning, campaign sequencing, or GTM messaging → marketing-automation
There is no credible shipped evidence yet → collect proof first instead of inventing release notes from a roadmap or TODO list
Instructions
Step 1: Classify one primary release-writing mode Normalize the request before drafting.
changelog_mode:
primary_mode: changelog | release-notes | migration-update | game-patch-notes
audience: developers | end-users | mixed | players | internal-stakeholders | unknown
release_scope: patch | minor | major | rolling | unknown
source_of_truth: release-pr | tagged-release | prs | issues | commits | docs | mixed | unknown
publishing_surface: changelog-file | github-release | docs-site | in-app-updates | steam-news | mixed | unknown
automation_context: manual | release-drafter | changesets | release-please | autogenerated-release-notes | mixed | unknown
output_shape: single-entry | summary-plus-links | migration-brief | patch-note-brief | sync-packet | unknown
changelog → durable repo history in CHANGELOG.mdrelease-notes → audience-facing summary of what changed and why it mattersmigration-update → changed behavior, required actions, deadlines, and compatibility notesgame-patch-notes → concise player-facing update summary
Step 2: Confirm audience, proof, and route-outs Answer these before writing:
Who reads this first?
What action should they take after reading it?
Which shipped evidence proves each headline claim?
Which deeper artifact should carry the rest?
If the request sounds like... Use “Write the architecture / rollout / runbook / internal migration plan” technical-writing“Publish API reference, SDK docs, auth troubleshooting, or portal pages” api-documentation“Write help docs, tutorials, screenshots, or FAQs for the changed workflow” user-guide-writing“Plan deploy / rollback / release execution” deployment-automation“Write launch copy / announcement / campaign messaging” marketing-automation“Summarize shipped changes truthfully for a release surface” changelog-maintenance
Step 3: Gather the smallest truthful evidence set Do not write release history from memory alone. Pull the smallest credible packet first:
merged release PR, tag, or release entry if it exists
merged PRs / issues / commits included in the release
linked migration docs, upgrade notes, or help docs
breaking changes, removals, deprecations, deadlines, or rollout caveats
publishing-surface constraints (CHANGELOG.md, GitHub Release, customer update hub, Steam patch-note post)
automation context, if any
If evidence is incomplete, label assumptions and missing proof explicitly.
Step 4: Choose the smallest useful artifact packet
single-entry → one changelog entry or one release-note blocksummary-plus-links → short release summary plus migration/help/API linksmigration-brief → what changed, who is affected, required action, deadline, link-outspatch-note-brief → concise new content / tuning / fixes / known issues packetsync-packet → release-note draft plus list of downstream docs or channels that must stay aligned Do not ship a broad handbook when one release packet and a short sync list will do.
Step 5: Apply mode-specific writing rules
Changelog : favor grouped notable changes over commit archaeology; keep compare links or version/date framing when the repo uses them.Release notes : lead with impact, not internal ticket numbers; keep wording plain and scannable.Migration update : foreground required action, affected readers, deadline, and compatibility risk.Game patch notes : keep the note lightweight and player-facing; do not smuggle rollout mechanics or campaign copy into it.
Step 6: Keep record, communication, and promotion separate Guard these boundaries aggressively:
changelog / release notes summarize what shipped
migration detail lives in linked migration docs when the procedure is too large for the summary
tutorials / FAQs live in user-guide-writing
API and integration detail lives in api-documentation
rollout / rollback mechanics live in deployment-automation
campaign-style language lives in marketing-automation
Step 7: Work with automation without surrendering judgment Use automation as draft input, not the final editor.
Release Drafter / autogenerated release notes → good for PR grouping and starter bulletsChangesets → good for package/version intent and monorepo release aggregationrelease-please / semantic-release style flows → good for release PRs, version bumps, and commit-driven summaries
the primary audience
what counts as notable
what needs a migration link
what should become a separate help/API/internal doc
Step 8: Run the trust check before publishing
Every claim matches shipped or merged evidence.
The chosen mode fits the audience and channel.
Breaking changes, removals, and deadlines are impossible to miss.
Route-outs stay explicit instead of bloating the note.
The packet is as small as possible while still truthful.
Step 9: Return a brief or the finished artifact Preferred brief shape before full drafting:
# Release Writing Brief
## Mode
- Primary mode:
- Why it fits:
- Audience:
- Output shape:
## Evidence used
- Source of truth:
- Supporting docs / links:
- Assumptions / missing proof:
## Planned artifact packet
1. main release artifact
2. downstream sync / linked-doc follow-up
## Writing notes
- Breaking changes / deadlines:
- Route-outs kept out of scope:
- Channel-specific constraints:
If the user already asked for the finished artifact, produce the selected packet directly with the matching structure.
Examples
Example 1: Changelog plus migration link
Update CHANGELOG.md for v2.4.0 from the merged PR list and make the Basic Auth deprecation obvious.
mode: changelog
output shape: summary-plus-links
grouped sections such as Added, Changed, Deprecated, Fixed
migration link or placeholder instead of embedding the full auth procedure
Example 2: Customer-facing release summary
Turn these shipped product updates into release notes customers will actually read.
mode: release-notes
output shape: single-entry or summary-plus-links
benefit-led headings like What’s new, Improvements, Fixes
route tutorials or help refreshes to user-guide-writing
Example 3: Lightweight game patch notes
Write patch notes for our latest game update and keep them short.
mode: game-patch-notes
output shape: patch-note-brief
concise sections for new content, tuning, fixes, and known issues
route launch-event hype or campaign beats to marketing-automation
Best practices
Start from shipped evidence, not vibes.
Pick one primary audience and one primary mode.
Use the smallest packet that fits the channel.
Separate release summary, migration detail, help docs, API docs, rollout mechanics, and launch messaging.
Let automation collect draft material, but do not outsource judgment.
Call out breaking changes and deadlines early.
Treat patch notes as a real workflow with player-facing constraints, not just a renamed changelog.
References 