메뉴
发版流程 - 仔细阅读上个版本到现在版本的内容，把更改功能放到项目CHANGELOG.md目录下，处理README图片引用，然后提交且推送所有源码到GitHub和Gitee双平台，再之后打tag 触发条件：用户要求发版、发布、release、打tag
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | release |
| description | 发版流程 - 仔细阅读上个版本到现在版本的内容，把更改功能放到项目CHANGELOG.md目录下，处理README图片引用，然后提交且推送所有源码到GitHub和Gitee双平台，再之后打tag 触发条件：用户要求发版、发布、release、打tag |
cat CHANGELOG.md
git describe --tags --abbrev=0
git log --oneline --decorate --graph $(git describe --tags --abbrev=0)..HEAD
确定新版本号（遵循语义化版本），添加新版本条目：
## [X.Y.Z] - YYYY-MM-DD
### 核心亮点
简要描述本版本的重要特性或改进
### Added
- 新功能列表
### Changed
- 修改的功能列表
### Fixed
- 修复的问题列表
遵循 readme-images skill 规则：
./docs/screenshots/xx.avif）遵循 image-compress skill 规则：
# 检查图片大小
bash .windsurf/skills/image-compress/scripts/check_compress.sh
git add .
git commit -m "release: v[版本号] 发布"
# 推送到 GitHub
git push github main
# 推送到 Gitee
git push gitee main
注意：由于 README 使用相对路径，两个平台共用同一份，无需分别处理。
git tag -a v[版本号] -m "Release v[版本号]"
git push github v[版本号]
git push gitee v[版本号]
如果项目包含多个子项目（如 frontend、backend 等）：
# 查看远程仓库配置
git remote -v
# 添加远程仓库（如果不存在）
git remote add github https://github.com/[username]/[repository].git
git remote add gitee https://gitee.com/[username]/[repository].git
发版时额外需要：
package.json → "version"src-tauri/tauri.conf.json → "version"src-tauri/Cargo.toml → versionnpm run tauri:build跳过 Gitee 相关步骤，仅推送到 GitHub。
git describe --tags --abbrev=0 # 查看最新标签
git tag --sort=-version:refname # 查看所有标签
git tag -d v[版本号] # 删除本地标签
git push github --delete v[版本号] # 删除远程标签
图片压缩检查规则。当添加或修改 README 引用的图片时自动触发。检查图片是否超过 100KB，超出则压缩。推荐使用 avif/webp 格式。触发场景：添加新图片到仓库、更新 README 中的截图、发版前检查。
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.
自动截屏功能页面。当用户需要更新项目文档截图、生成功能演示图、或需要记录当前 UI 状态时触发。
前端组件设计规范与最佳实践。在编写任何前端代码（React/Next.js 组件、页面、hooks）时自动触发。确保代码复用性、封装性、单一职责原则。触发场景包括创建新的前端组件或页面、重构现有前端代码、添加新功能到前端、任何涉及 frontend 目录的代码修改。此技能始终生效。
后端代码测试验证规则。此技能在以下情况下自动触发： - 任何后端代码修改（backend/ 目录下的 .py 文件） - 新增功能开发 - Bug 修复 - 代码重构 核心原则： 1. 后端代码修改必须有对应的测试用例 2. 修改业务逻辑时必须同步更新相关测试用例 3. 测试全部通过才算功能完成 触发关键词：后端、backend、python、测试、test、pytest、功能、feature、修复、fix、实现、修改、完成、验证 alwaysApply: true