agentleFS
agent-toweragent-tower/core/.agents/skills/github-desktop-release/SKILL.md

github-desktop-release

Skill399 starsChanged 7 days agoApache-2.0View on GitHub

通过 GitHub Actions 发布 Agent Tower 桌面端多平台安装包。当用户要求发布 GitHub release、触发 GitHub 自动打包、发桌面版、构建 macOS/Windows/Linux 安装包或处理桌面包 CI 发布时使用此 skill。

  • Commits and pushes

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. EthanYoQ/Skill-hub★ 11same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository7 other files it gives its agents.

The file

Files
SKILL.md

GitHub Desktop Release

用于通过 .github/workflows/build-desktop.yml 触发桌面端多平台打包,并生成 GitHub draft release。

触发机制

  • push tag 且 tag 匹配 v*:自动构建 macOS/Windows/Linux 桌面包,并创建或更新 draft GitHub Release。
  • workflow_dispatch:只手动构建并上传 Actions artifacts,不创建 GitHub Release。

正式发布桌面包时优先用 tag push,不要只手动跑 Action。

发布前检查

  1. 确认工作区状态:
git status --short
  1. 确认当前版本来源:
  • npm/server 版本在 packages/server/package.json
  • desktop 包版本在 tag workflow 中由 tag 临时写入 packages/desktop/package.json
  • tag 必须是 semver 形式,例如 v0.5.2-beta.6
  1. 构建前本地至少验证:
pnpm --filter @agent-tower/server build
pnpm --filter @agent-tower/desktop run package:prepare

如改过 Linux metadata 或 Electron Builder 配置,再跑:

pnpm --filter @agent-tower/desktop run package:linux

触发 GitHub 自动打包

  1. 创建并推送 tag:
git tag vX.Y.Z
git push origin vX.Y.Z

如果 tag 已存在且需要重发,先和用户确认。不要擅自删除或强推 tag。

  1. 查看 workflow:
gh run list --workflow "Build Desktop" --limit 5
gh run watch <run-id>
  1. 查看产物:
gh run download <run-id> --dir desktop-artifacts
  1. 查看 draft release:
gh release view vX.Y.Z

GitHub Release 行为

tag push 成功后 workflow 会:

  • 在 macos-latest 构建 macOS arm64 DMG
  • 在 windows-latest 构建 Windows x64 NSIS installer 和 portable exe
  • 在 ubuntu-latest 构建 Linux x64 AppImage 和 deb
  • 上传 Actions artifacts,保留 14 天
  • 创建或更新 draft GitHub Release,并上传所有平台产物

发布 draft release 前,检查产物齐全后再执行:

gh release edit vX.Y.Z --draft=false

预发布版本可标记 prerelease:

gh release edit vX.Y.Z --prerelease --draft=false

常见问题

  • Prisma 类型错误:确认 packages/server/package.json 的 build 会先跑 pnpm run db:generate。
  • Windows cp 不存在:server build 资产复制应使用 Node 脚本,不用 Unix-only cp。
  • Linux deb 报 Please specify project homepage:packages/desktop/package.json 顶层需要 homepage。
  • Linux WM_CLASS warning:顶层 desktopName 配合 build.linux.syncDesktopName: true。
  • macOS 包目前未签名/未公证;正式分发前需要 Developer ID signing/notarization。
  • Windows 包目前未签名;正式分发前需要代码签名。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.