- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add LC044/TrailSnap --skill release-publisher -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add LC044/TrailSnap --skill release-publisher -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add LC044/TrailSnap --skill release-publisher -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add LC044/TrailSnap --skill release-publisher -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/LC044/TrailSnap/tree/HEAD/.agents/skills/release-publisher來自發布者
严格按顺序执行。完整性优先于打标签;未经用户确认,不得创建 GitHub Release。
PowerShell 可按版本对象排序标签:
$lastTag = git tag --list |
Where-Object { $_ -match '^v\d+\.\d+\.\d+$' } |
Sort-Object { [version]($_ -replace '^v', '') } -Descending |
Select-Object -First 1
以下是当前基线清单,不是完整清单。先更新这些位置,再用 git grep 发现新增位置。
runtime-version.json 必须与桌面版本一致。python package/desktop/scripts/validate_components.py;缺少组件或混合版本时停止发布。bundledAI: true。完成后再次搜索旧版本:
按功能模块归并最终用户可见结果,不要机械罗列 commit。
必须在创建标签前完成:
releases/ 通常被 git 忽略;确认三个文件存在即可,不强行提交。
依次执行:
在 package/official-site 下解析 public/version.json。
在 package/official-site 下运行 pnpm docs:build。
检查master上次提交触发的ci测试是否通过,如果通过则无需操作,如果未通过则先进行修复,确保ci全绿之后再进行下一步,可以在仓库根目录运行完整 E2E进行自测:
pwsh .\tests\scripts\run-tests.ps1 -Layer e2e -Level full
若失败:
审查 git diff、git diff --check 和工作区状态。
提交所有版本号、官网日志、version.json 及必要的发布测试修复。
使用 Conventional Commits,例如 chore(release): prepare vX.Y.Z。
除非用户明确要求,不在提交消息中加入镜像或包发布触发词。
推送当前分支,确认本地 HEAD 与远程一致且工作区干净。
向用户完整展示 release-notes.md。
明确说明官网构建和完整 E2E 结果。
等待用户确认。
确认后创建 Release:
gh release create vX.Y.Z --title "vX.Y.Z" --notes-file "releases\vX.Y.Z\release-notes.md"
记录 Release URL、标签 SHA 和创建时间。
不要手动重复创建标签;gh release create 会创建并推送标签。
不得移动已发布标签或删除 Release,除非用户明确授权。
创建 Release 后不要立即结束。持续监控该标签触发的工作流,直到全部进入 completed。
当前应关注的工作流基线:
使用 gh run list --branch vX.Y.Z 和 gh run view 检查状态、矩阵任务及失败步骤。
从当前工作流定义推导预期附件,不使用历史版本的固定数量:
验收要求:
manifest.json 必须声明 bundledAI: true,且 server/ 与 ai/ 两套独立运行环境完整;验证签名、SHA-256、正常启动和失败整体回滚。模型与照片不能被打进程序更新归档。多个上传工作流可能使用 generate_release_notes 更新同一个 Release,从而修改标题。
所有 CI 完成后必须:
检查 Release 标题和正文。
将其与用户确认过的 release-notes.md,追加的 “What's Changed”可以保留。
若标题或正文被改变,恢复:
gh release edit vX.Y.Z --title "vX.Y.Z" --notes-file "releases\vX.Y.Z\release-notes.md"
从 gh release view vX.Y.Z --json assets 的 assets[].url 读取浏览器直链,在本地 release-notes.md 末尾生成或替换 ## 安装包下载:
url,不要使用 apiUrl## 安装包下载 时替换该节,不得重复追加若任何预期安装包缺失,停止并报告,不得发布不完整的下载区或宣称验收成功。
使用更新后的 release-notes.md 再次恢复 Release 标题和正文:
gh release edit vX.Y.Z --title "vX.Y.Z" --notes-file "releases\vX.Y.Z\release-notes.md"
再次确认正文与更新后的 release-notes.md 完全一致、安装包直链均来自已验收附件、附件数量不变且全部 uploaded。
下载release里的各个平台的安装包(只需要安装包)将其放到\\DXP4800PLUS-72A\personal_folder\电脑软件\TrailSnap\X.Y.Z 文件夹下留作本地备份,如果文件夹不能访问则跳过该步骤。
Skill 不自动向社交平台发布内容,只生成文件并提醒用户审阅。
报告以下内容:
若任何 CI 或预期附件失败,不得宣称发布全部成功。
发布并验收 TrailSnap 新版本:汇总提交、同步全项目版本号、更新官网日志与客户端更新清单、执行发布前测试、创建 GitHub Release、监控标签 CI、核验 Release 附件,并生成小红书和公众号文案。Use when the user asks to 发布新版本、发版、创建或检查 GitHub Release、总结版本变更、监控发布 CI、检查发布产物,或撰写版本更新帖子。
---name: release-publisherdescription: 发布并验收 TrailSnap 新版本:汇总提交、同步全项目版本号、更新官网日志与客户端更新清单、执行发布前测试、创建 GitHub Release、监控标签 CI、核验 Release…---# .agents/skills/release-publisher/SKILL.md常見問題
從發布者下載 .agents/skills/release-publisher/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/LC044/TrailSnap。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。