Agent Skill · 开发规范

release-and-changeset-best-practices（发布和变更集最佳实践）

release-and-changeset-best-practices 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

release-and-changeset-best-practices 是开发规范类 Agent Skill，可用宿主为 Codex、Claude、Cursor、Gemini CLI，通过GitHub 仓库获取，权限为调用外部服务；许可证信息还不明确，第三方扫描已通过，按安装量在开发规范类的 1,265 个 Skill 里排第 713。

总安装 558周安装 23GitHub Stars 公开资料未说明下载 182核验 2026-05-01

开发规范调用外部服务 GitHub 仓库未标认证来源可访问许可证需确认审计通过 Codex Claude Cursor Gemini CLI

安装说明

本站只整理中文说明，不托管安装包，也不代用户安装。

GitHub

许可证: unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：release-and-changeset-best-practices（发布和变更集最佳实践）
来源仓库：https://github.com/sonofmagic/skills
仓库路径：skills/release-and-changeset-best-practices
安装命令：
npx skills add https://github.com/sonofmagic/skills --skill release-and-changeset-best-practices
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/sonofmagic/skills --skill release-and-changeset-best-practices

这个 Skill 是做什么的

开发规范类 Skill 用来统一代码风格、目录结构和评审口径，产出多为检查清单或改写建议。

release-and-changeset-best-practices 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息。适合在 Codex、Claude、Cursor、Gemini CLI 中围绕仓库状态、代码变更或协作事项进行整理。

通过 npx skills add 命令从指定 GitHub 仓库安装并使用。安装前需确认权限范围、维护状态，注意是否触发联网、命令执行或文件读写操作。适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

来源仓库内路径：skills/release-and-changeset-best-practices

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Codex、Claude、Cursor、Gemini CLI；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npx skills add https://github.com/sonofmagic/skills --skill release-and-changese…；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要调用外部服务，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

release-and-changeset-best-practices 怎么安装？

在终端执行 npx skills add https://github.com/sonofmagic/skills --skill release-and-changeset-best-pra…。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

release-and-changeset-best-practices 支持哪些 AI 工具？

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

release-and-changeset-best-practices 需要什么权限？

权限级别是调用外部服务。该 Skill 可能调用第三方服务、云服务或外部模型 API，使用前需要确认账号、额度、数据发送范围和服务条款。

release-and-changeset-best-practices 是免费的吗？

公开资料没有标注明确许可证，收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

release-and-changeset-best-practices 用的人多吗？

公开数据是累计安装 558 次，近一周安装 23 次，下载 182 次。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

release-and-changeset-best-practices 安全吗？

第三方扫描结果为通过，但这只覆盖已知的静态检查项，不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

同时适配 4 种工具，换客户端不用重新找替代品。
第三方扫描已通过，常见的高风险行为没有命中。

先想清楚的地方

许可证没有明确标注，能不能商用、能不能再分发都不确定。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Codex，想直接扩展它能力的人。
需要处理开发规范类任务、又不想每次都手写提示词的人。

不太适合

需要明确授权才能用到公司项目里的场景。
需要厂商级技术支持和 SLA 的生产系统。

开发规范类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
vercel-react-best-practices Vercel React 最佳实践 · Codex、Claude	8,490,720	25,918	操作浏览器	MIT	通过
web-design-guidelines 网页设计指南 · Codex、Claude	6,686,016	25,885	需要联网	MIT	有提醒
remotion-best-practices Remotion 最佳实践 · Codex、Claude	6,505,632	3,027	操作浏览器	MIT	有提醒
supabase-postgres-best-practices Supabase Postgres 最佳实践 · Codex、Claude	3,175,523	2,030	需要联网	MIT	通过
next-best-practices Next.js 最佳实践 · Codex、Claude	1,848,240	841	操作浏览器	MIT	通过
release-and-changeset-best-practices 发布和变更集最佳实践 · 本页	558	—	调用外部服务	未明确	通过

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

release-and-changeset-best-practices

用途

统一 changeset、提交、版本联动和发布前检查，避免漏掉用户可见改动和脚手架联动。

何时使用

用户问“这个改动要不要加 changeset”。
用户要补 .changeset/*.md。
用户准备发布。
用户改了 weapp-vite / wevu / templates/* / skills/* / dist/docs / AGENTS.md / website。
用户改了 AI 使用路径，如 screenshot / compare / MCP / logs / skills 安装。
用户要求按仓库流程修 GitHub issue，包括 worktree、最小复现、PR、中文变更说明与 CI 收尾。

不适用场景

本 skill 聚焦仓库交付流程，包括 release 判定、changeset 治理和 issue 修复闭环。

文档同步：使用 docs-and-website-sync。
构建或运行时设计：使用对应 best-practices skill。

核心流程

先判断改动是否用户可见；源码 bug fix、功能新增、行为变化、模板行为变化默认要补 changeset。
下列改动不要轻易归类为“纯内部维护”：

- skills/* - dist/docs - 脚手架生成 AGENTS.md - AI skills 安装行为 - prepare / mcp init|print|doctor / forwardConsole - wv screenshot / wv compare / wv ide logs - web runtime / lib mode

若 release 涉及 weapp-vite、wevu 或 templates/*，默认联动补 create-weapp-vite bump。
changeset summary 用中文，描述用户感知结果，不写成内部重构流水账。
若任务来自 GitHub issue：

- 先在仓库可写目录创建 git worktree - 优先在 e2e-apps/github-issues 或最小入口稳定复现 - 先补根因相关 unit / e2e，再做 PR 收尾

交付遵循 Conventional Commits；默认 commit-only，issue 修复走 PR 流程。
发布前优先跑仓库脚本：

- node --import tsx scripts/check-create-weapp-vite-changeset.ts - node --import tsx scripts/check-catalog-changeset.ts - 需要时再跑 pnpm release、pnpm cv、pnpm publish-packages

约束

不要漏掉源码 bug fix 的 changeset。
不要忘记 create-weapp-vite 联动。
不要写英文或空泛的 summary。
不要把用户可见的 AI / docs / template 合约误判成纯内部改动。
不要在复现不稳定时直接修源码并开 PR。

输出

应用本 skill 时，输出必须包含：

是否需要 changeset 及理由。
是否需要 create-weapp-vite 联动。
推荐提交类型。
推荐检查命令。
若来自 issue，补充复现路径与 PR 交付状态。

完成标记

changeset 需求已判断清楚。
需要时已补中文 changeset。
需要时已补 create-weapp-vite bump。
提交方式和交付方式符合仓库规则。
issue 修复时已完成 worktree、复现、回归与 PR 闭环。

参考资料

references/release-checklist.md
references/issue-fix-checklist.md

平台分布

Codex

32.6%

按下载量换算59

Claude

30.55%

按下载量换算56

Cursor

19.63%

按下载量换算36

Gemini CLI

8.73%

按下载量换算16

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

调用外部服务

该 Skill 可能调用第三方服务、云服务或外部模型 API，使用前需要确认账号、额度、数据发送范围和服务条款。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源，建议同时核对源仓库。

继续浏览同类 Skills

更多开发规范 Skills（1,265）返回 Skills 目录

上一个 Skill

redux-best-practices（还原最佳实践）

felipeorlando/redux-best-practices

redux-best-practices 用于记录任务执行中的错误、用户纠正、经验和能力缺口，适合在 Codex、Claude、Cursor、Gemini CLI 中希望让 Agent 持续沉淀问题、修正和最佳实践时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

remix-game-best-practices（混音游戏最佳实践）

farworld-labs/remix-skills

remix-game-best-practices 用于记录任务执行中的错误、用户纠正、经验和能力缺口，适合在 Codex、Claude、Cursor、Gemini CLI 中希望让 Agent 持续沉淀问题、修正和最佳实践时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。