release
发版流程 - 仔细阅读上个版本到现在版本的内容，把更改功能放到项目CHANGELOG.md目录下，处理README图片引用，然后提交且推送所有源码到GitHub和Gitee双平台，再之后打tag 触发条件：用户要求发版、发布、release、打tag
Best use case
release is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
发版流程 - 仔细阅读上个版本到现在版本的内容，把更改功能放到项目CHANGELOG.md目录下，处理README图片引用，然后提交且推送所有源码到GitHub和Gitee双平台，再之后打tag 触发条件：用户要求发版、发布、release、打tag
Teams using release should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/release/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How release Compares
| Feature / Agent | release | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
发版流程 - 仔细阅读上个版本到现在版本的内容，把更改功能放到项目CHANGELOG.md目录下，处理README图片引用，然后提交且推送所有源码到GitHub和Gitee双平台，再之后打tag 触发条件：用户要求发版、发布、release、打tag
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 发版 Skill ## 依赖的 Skills - **readme-images** — 确认 README 图片使用相对路径 - **image-compress** — 确认图片 < 100KB ## 发版流程 ### 1. 检查当前版本状态 ```bash cat CHANGELOG.md git describe --tags --abbrev=0 ``` ### 2. 分析版本变更 ```bash git log --oneline --decorate --graph $(git describe --tags --abbrev=0)..HEAD ``` ### 3. 更新 CHANGELOG.md 确定新版本号（遵循语义化版本），添加新版本条目： ```markdown ## [X.Y.Z] - YYYY-MM-DD ### 核心亮点 简要描述本版本的重要特性或改进 ### Added - 新功能列表 ### Changed - 修改的功能列表 ### Fixed - 修复的问题列表 ``` ### 4. 检查 README 图片 遵循 `readme-images` skill 规则： - 确认所有图片使用**相对路径**（如 `./docs/screenshots/xx.avif`） - 不使用七牛云 URL、GitHub Raw URL 或 CDN 遵循 `image-compress` skill 规则： - 确认所有图片 < 100KB ```bash # 检查图片大小 bash .windsurf/skills/image-compress/scripts/check_compress.sh ``` ### 5. 提交并推送（双平台，一次提交） ```bash git add . git commit -m "release: v[版本号] 发布" # 推送到 GitHub git push github main # 推送到 Gitee git push gitee main ``` > 注意：由于 README 使用相对路径，两个平台共用同一份，无需分别处理。 ### 6. 创建版本标签（双平台） ```bash git tag -a v[版本号] -m "Release v[版本号]" git push github v[版本号] git push gitee v[版本号] ``` ## 版本号规则 遵循 [Semantic Versioning](https://semver.org/)： - **MAJOR**：不兼容的 API 修改 - **MINOR**：向下兼容的功能性新增 - **PATCH**：向下兼容的问题修正 ## 多子项目处理 如果项目包含多个子项目（如 frontend、backend 等）： 1. **主项目 CHANGELOG**：记录整体项目变更 2. **子项目 CHANGELOG**：记录子模块特定变更 3. **版本同步**：确保相关子项目版本号保持一致 ## 远程仓库设置 ```bash # 查看远程仓库配置 git remote -v # 添加远程仓库（如果不存在） git remote add github https://github.com/[username]/[repository].git git remote add gitee https://gitee.com/[username]/[repository].git ``` ## 发布前检查清单 - [ ] 所有代码已提交 - [ ] CHANGELOG.md 已更新 - [ ] 版本号符合语义化版本规范 - [ ] README 图片使用相对路径（遵循 readme-images skill） - [ ] 图片大小 < 100KB（遵循 image-compress skill） - [ ] 远程仓库已配置（GitHub + Gitee） - [ ] 标签已创建并推送到双平台 - [ ] 双平台仓库已同步 ## 特殊项目说明 ### Tauri 应用（如 wdm） 发版时额外需要： 1. **同步更新版本号**（3 处）： - `package.json` → `"version"` - `src-tauri/tauri.conf.json` → `"version"` - `src-tauri/Cargo.toml` → `version` 2. **构建应用**：`npm run tauri:build` 3. **上传 DMG 到 GitHub/Gitee Release** ### 仅 GitHub 的项目（如 cong_wa_skills） 跳过 Gitee 相关步骤，仅推送到 GitHub。 ## 常用命令 ```bash git describe --tags --abbrev=0 # 查看最新标签 git tag --sort=-version:refname # 查看所有标签 git tag -d v[版本号] # 删除本地标签 git push github --delete v[版本号] # 删除远程标签 ```
Related Skills
web-design-guidelines
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
ui-ux-pro-max
Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
tailwindcss
Tailwind CSS v4 utility-first styling patterns including responsive design, dark mode, and custom configuration. Use when styling with Tailwind, adding utility classes, configuring Tailwind, setting up dark mode, or customizing the theme.
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
run-tests
后端代码测试验证规则。此技能在以下情况下自动触发： - 任何后端代码修改（backend/ 目录下的 .py 文件） - 新增功能开发 - Bug 修复 - 代码重构 核心原则： 1. 后端代码修改必须有对应的测试用例 2. 修改业务逻辑时必须同步更新相关测试用例 3. 测试全部通过才算功能完成 触发关键词：后端、backend、python、测试、test、pytest、功能、feature、修复、fix、实现、修改、完成、验证 alwaysApply: true
readme-images
Handle README.md image references for GitHub and Gitee platforms. Use when writing or converting README.md files that contain images, ensuring correct image paths for each platform. GitHub READMEs use Qiniu cloud URLs (via qiniu-upload skill), Gitee READMEs use local relative image paths.
qiniu-upload
Upload images to Qiniu Cloud (七牛云) via local PicList/PicGo service and return the public access URL. Use when the user needs to upload images, screenshots, or any picture files to Qiniu cloud storage, get image hosting URLs, or publish images to http://qiniu.biomed168.com/pic/.
mobile-automation
Mobile MCP + 飞书 MCP 双协作自动化测试专家。
image-compress
图片压缩检查规则。当添加或修改 README 引用的图片时自动触发。检查图片是否超过 100KB，超出则压缩。推荐使用 avif/webp 格式。触发场景：添加新图片到仓库、更新 README 中的截图、发版前检查。
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.