菜单
React on Rails release-train changelog updates, including target=release and release/X.Y.Z PR targeting while the portable update-changelog skill remains mainline-only.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/shakacode/react_on_rails --skill react-on-rails-update-changelog命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | react-on-rails-update-changelog |
| description | React on Rails release-train changelog updates, including target=release and release/X.Y.Z PR targeting while the portable update-changelog skill remains mainline-only. |
| argument-hint | [classification-sweep BASE_REF..TARGET_REF|release|rc|beta|version] [target=main|release|release/X.Y.Z] |
Use this repo-local skill only when React on Rails release-train targeting matters:
target=release or target=release/X.Y.Zrelease/X.Y.Zrelease/X.Y.ZFor ordinary mainline changelog entries on main, use the installed/shared
$update-changelog skill. This repo-local skill exists under a distinct name so
Codex does not show a duplicate update-changelog picker entry.
Before editing, read:
AGENTS.md changelog and release-train sections.internal/contributor-info/release-train-runbook.md when the target is a
release/* branch..agents/agent-workflow.yml for base_branch, changelog, and changelog
policy values.Resolve the shared helper directory explicitly; do not assume this checkout has a repo-local shared skill copy:
UPDATE_CHANGELOG_SKILL_DIR="${UPDATE_CHANGELOG_SKILL_DIR:-$(.agents/bin/shared-skill-dir update-changelog)}"
Use that helper for mechanical classification sweeps:
BASE_REF="${BASE_REF:?set BASE_REF, e.g. v17.0.0.rc.2}"
TARGET_REF="${TARGET_REF:?set TARGET_REF, e.g. origin/main or origin/release/17.0.0}"
"${UPDATE_CHANGELOG_SKILL_DIR}/bin/changelog-merged-prs" "${BASE_REF}..${TARGET_REF}"
Resolve the target before writing, stamping, branching, or creating a PR:
target=main: use the installed/shared $update-changelog flow against the
configured base branch.target=release/X.Y.Z: verify origin/release/X.Y.Z exists and target that
branch.target=release: use the current release/X.Y.Z branch when already on one;
otherwise list origin/release/*. If exactly one active release branch exists,
target it. If more than one exists, ask which branch to use.target= while on release/X.Y.Z: target the current release branch.target= while on main and exactly one active origin/release/* branch
exists: ask whether this changelog update should target release/X.Y.Z or
main. Default to main only when the user does not choose a release target.main.If a requested release target does not exist on origin, stop and report:
target=release requested but no matching origin/release/X.Y.Z branch exists.
Start the release line first, or use target=main.
For a resolved release/X.Y.Z target:
Fetch current release state:
git fetch --prune origin main '+refs/heads/release/*:refs/remotes/origin/release/*'
Require a clean worktree before changing branches or writing changelog entries.
Create a feature branch from the release branch tip, not from main:
git switch -c "changelog-<version-or-mode>" "origin/release/X.Y.Z"
Add or curate entries in CHANGELOG.md under ### [Unreleased], using the
classification taxonomy and entry format from AGENTS.md.
Run the repo's version-stamping task when requested:
bundle exec rake "update_changelog[rc]"
bundle exec rake "update_changelog[release]"
bundle exec rake "update_changelog[beta]"
bundle exec rake "update_changelog[17.0.0.rc.1]"
Keep compare-link anchoring consistent with the repo task. Release-target
entries intentionally keep the [unreleased] comparison anchored to main
because release-branch entries are forward-ported to main.
Commit only the changelog files, push the feature branch, and open the PR against the release branch:
git add CHANGELOG.md
git commit -m "Update changelog for <version-or-mode>"
git push -u origin "$(git branch --show-current)"
gh pr create --draft --base "release/X.Y.Z" --head "$(git branch --show-current)"
After the PR merges into release/X.Y.Z, follow the release-train runbook to
forward-port the changelog result to main when required.
Do not recreate .agents/skills/update-changelog/SKILL.md in this repo unless a
maintainer explicitly chooses to restore a same-name local override and accepts
the duplicate skill picker entry. Keep same-name shared workflow skills in the
installed shared pack.