| name | jfox-release-all |
| description | Release all three components (jfox CLI + cc-plugin + kimi-plugin) in one command.
Detects per-component changes since last release, skips unchanged ones, batches bump
PRs, then creates the jfox GitHub Release last (with CHANGELOG verify).
Triggers on: "全发", "release all", "三件套发版", "一起发版", "release everything",
"orchestrate release".
|
Release-All Skill
一条命令编排三条独立发版轨道：jfox CLI → cc-plugin → kimi-plugin。自动检测各组件自上次发版以来的改动，跳过无改动者；为有改动者批量建 bump PR；用户合并后，最后发 jfox GitHub Release（带 #333 verify 校验）。
⚠️ 三组件版本轨道独立、语义各自不同。本 skill 不统一版本号，只统一编排。
要单独发某一组件，用 /skill:jfox-release、/skill:jfox-release-cc-plugin、/skill:jfox-release-kimi-plugin。
用法
/skill:jfox-release-all # 逐组件确认 suggested_bump
/skill:jfox-release-all minor # 统一指定 bump 类型（套用到所有 changed 组件）
/skill:jfox-release-all patch
编排模型
批量建 PR + 最后发 jfox Release：detect 全部 → 展示计划 → 为每个 changed 组件 bump+建 PR → 用户依次合并全部 PR → 拉最新 main → verify → 建 jfox GitHub Release。
执行流程
Step 1: 前置校验（任一不符即停）
git branch --show-current
git status --porcelain
git branch --list 'chore/bump-*'
gh pr list --state open --json headRefName --jq '.[].headRefName' | grep 'chore/bump-'
Step 2: 检测
uv run python .claude/skills/release-all/release_all_helper.py detect
Step 3: 展示合并计划 + 确认 bump 类型
展示 detect 结果：
📦 Release-All 计划:
jfox 1.5.0 → 1.6.0 (minor) ✓ 有改动 [feat(backup)#339, feat(gem-synth)#335]
cc-plugin 0.6.0 → 0.6.1 (patch) ✓ 有改动 [docs(promote)#342]
kimi-plugin 0.14.0 ✗ 无改动，跳过
- 命令带参数（
/skill:jfox-release-all minor）→ 统一套用到所有 changed 组件。
- 否则逐组件确认 suggested_bump（用户可改 patch/minor/major 或指定 x.y.z）。
- 全部 changed=false → 打印「三组件均无未发布改动，无需发版」并结束。
Step 4: 逐组件 bump + 建 PR（顺序 jfox → cc → kimi，仅 changed 者）
detect 已算出 suggested_version 并经确认，跳过各单组件 skill 的 dry-run 预览步。
⚠️ 每个组件开始前必须先 git checkout main：上一组件的 bump 提交落在它自己的分支上，若不回 main，下一组件的 git checkout -b 会从上一组件分支拉出，导致 PR diff 串进别的组件文件（如 cc PR 里混入 jfox 的 pyproject.toml）。
对每个 changed 组件，循环执行（helper 在 main 工作树改文件 → 从 main 拉 bump 分支 → commit → push → 开 PR）：
git checkout main（确保下一组件从干净的 main 拉分支）- 正式 bump + 建分支 + commit + push + 开 PR（每条都用完整命令，
git push 须带 -u 设 upstream）：
- jfox：
uv run python .claude/skills/release/release_helper.py <v> → git checkout -b chore/bump-version-<v> → git add pyproject.toml jfox/__init__.py uv.lock CHANGELOG.md → git commit -m "chore: bump version to <v>" → git push -u origin chore/bump-version-<v> → gh pr create --title "chore: bump version to <v>" --body "<changelog_preview>"
- cc-plugin：
uv run python .claude/skills/release-cc-plugin/release_cc_plugin_helper.py <v> → git checkout -b chore/bump-cc-plugin-<v> → git add packages/cc-plugin/.claude-plugin/plugin.json .claude-plugin/marketplace.json → git commit -m "chore(cc-plugin): bump version <cur> → <v>" → git push -u origin chore/bump-cc-plugin-<v> → gh pr create --title "chore(cc-plugin): bump version <cur> → <v>" --body "<changelog>"
- kimi-plugin：
uv run python .claude/skills/release-kimi-plugin/release_kimi_plugin_helper.py <v> → git checkout -b chore/bump-kimi-plugin-<v> → git add packages/kimi-plugin/kimi.plugin.json → git commit -m "chore(kimi-plugin): bump version <cur> → <v>" → git push -u origin chore/bump-kimi-plugin-<v> → gh pr create --title "chore(kimi-plugin): bump version <cur> → <v>" --body "<changelog>"
三组件文件不冲突，PR 可并存。收集所有 PR URL。
Step 5: 告知用户合并
已创建 N 个 bump PR：
- jfox: <URL>
- cc-plugin: <URL>
- kimi-plugin: <URL>
请依次合并后告知我，我将继续创建 jfox GitHub Release（cc/kimi 合 main 即生效，无需 Release）。
等待用户确认全部合并。只有 jfox 在计划内时才需要合并后回流；若 jfox 被跳过，cc/kimi 合完即结束。
Step 6: 发 jfox Release（仅当 jfox 在计划内）
git checkout main && git pull origin main
uv run python .claude/skills/release/release_helper.py verify
gh release create v<jfox_ver> --title "v<jfox_ver>" --notes "<changelog_preview>"
verify 非 0 → 打印 missing 条目，停，提示用户补 CHANGELOG（开 docs(changelog) PR 合并）后重跑 verify + release。不自动建 Release。
跳过提示
detect 阶段 changed=false 的组件，全程打印一次「<组件> 自 以来无改动，跳过」后不再出现。
错误处理
- detect 某组件异常 → 该组件 changed=false + skip_reason，继续其他组件，不中断。
- 某组件 bump 中途失败 → 已建的早期组件 PR 保留（独立），报告失败组件、停。
- 用户只合并部分 PR → Step 6 不执行，提示「还有 X 个 PR 未合并」。
- verify 非 0 → 不建 Release，打印 missing，停。
与单组件 skill 的关系
/skill:jfox-release、/skill:jfox-release-cc-plugin、/skill:jfox-release-kimi-plugin 不变其单组件职责。- 本 skill 是编排层，委托三组件 helper，自身只做 detect + 调度 + skip + verify 串接，无特判分支。
