feat: release pipeline + skill package + English README#18
Merged
Conversation
- docs/design/release-pipeline.md: single source of truth for release pipeline - docs/superpowers/plans/2026-06-03-release-pipeline-skill.md: detailed task plan Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
… (gitignored) Moved from docs/design/release-pipeline.md to release/release-pipeline.md. The file is now excluded from git tracking via .gitignore (release/*). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…ctron Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
🔒 门禁检查结果
Rust 测试覆盖率
前端测试覆盖率
✅ 所有检查通过,可以合入
|
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Add Linux CI skip (macOS frameworks required) - Add cargo build fallback when binaries not found - Fixes unified-test CI failure Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
CI populates packages/*/bin/ and packages/*/app/ at publish time. These should not be committed. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…oncise layout - Add "For Humans" section: paste one prompt into Claude Code to install - Add Demo section with 4 screenshots showing Claude, OpenCode, multi-tab - Simplify Features to one-line table - Merge CLI + MCP into Quick Reference code block - Remove How it works architecture diagram (replaced by screenshots) - Update Chinese README with same structure Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Replace rm -rf of entire release/ with targeted removal of build artifacts - Preserve git-tracked files like release-pipeline.md - Update skill paths from skill/ to packages/cli-box-skill/skill/ - Fix chmod glob-in-quotes by listing files explicitly Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Previously only ran on push to main, so build failures were discovered after merge. Now runs on any event where gate passes, catching issues before merge. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
解决的问题
1. 缺少自动化发布流程
问题: 没有一键构建 + 发布的流程,每次发版需要手动操作多个步骤。
解决方案:
release.sh一键构建脚本:Rust CLI/daemon 二进制 + Electron 应用 + skill tarball + npm platform packagesrelease.ymlGitHub Actions 工作流:自动构建 + npm 发布release/release-pipeline.md设计文档2. 用户安装门槛高
问题: 用户需要手动下载、解压、配置 PATH,步骤繁琐。
解决方案:
npm install -g cli-box-skill,自动安装二进制 + skillbash <(curl -fsSL .../install.sh)postinstall.mjs:npm 安装后自动创建 symlink + 安装 SKILL.md 到 Claude/OpenCode 目录cli-box-wrapper.js:支持npx cli-box直接运行3. Skill 文件位置混乱
问题: Skill 文件散落在
skill/目录,npm 包结构不清晰。解决方案:
packages/cli-box-skill/(主包) +packages/cli-box-darwin-arm64/(平台包) +packages/cli-box-electron-darwin-arm64/(Electron 平台包)optionalDependencies+os/cpu字段自动匹配平台packages/cli-box-skill/skill/4. E2E 测试缺失
问题: Skill 安装流程没有自动化测试,CI 无法验证。
解决方案:
tests/e2e-skill-install.sh:在 tmp 目录隔离测试 postinstall.mjs 和 install.shtest.sh:CI 自动运行 E2E 测试5. release.sh 多个 bug
问题:
rm -rf "$RELEASE_DIR"删除了 git 跟踪的release-pipeline.mdskill/→packages/cli-box-skill/skill/)chmod +x "$DIR/*"glob 在双引号内不展开解决方案:
chmod +x "$DIR/cli-box" "$DIR/cli-box-daemon"6. CI 发布构建验证时机错误
问题:
release-buildjob 只在 push to main 时运行,合并后才发现构建失败。解决方案: 改为门禁通过后即运行(PR + push),合并前验证构建。
7. README 缺少吸引力
问题: README 没有快速安装指引,用户不知道怎么开始。
解决方案:
文件变更
release.sh.github/workflows/release.ymlpackages/cli-box-skill/packages/cli-box-darwin-arm64/packages/cli-box-electron-darwin-arm64/tests/e2e-skill-install.sh.github/assets/demo-*.pngREADME.mdREADME.zh-cn.md.github/workflows/ci.ymltest.sh.gitignore测试
test.sh全部通过 (Rust fmt + clippy + test + frontend + E2E)🤖 Generated with Claude Code