- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add LC044/TrailSnap --skill release-publisher -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add LC044/TrailSnap --skill release-publisher -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add LC044/TrailSnap --skill release-publisher -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add LC044/TrailSnap --skill release-publisher -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/LC044/TrailSnap/tree/HEAD/.agents/skills/release-publisherTừ nhà phát hành
严格按顺序执行。完整性优先于打标签;未经用户确认,不得创建 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.mdCâu hỏi thường gặp
Tải .agents/skills/release-publisher/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/LC044/TrailSnap.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.