Initial commit
This commit is contained in:
Zhongwei Li
12
.claude-plugin/plugin.json
Normal file
12
.claude-plugin/plugin.json
Normal file
@@ -0,0 +1,12 @@
|
||||
{
|
||||
"name": "auto-release-manager",
|
||||
"description": "Automate version updates and releases for any project type (Node.js, Python, Rust, Unity, Unreal, etc.) with intelligent project detection and cross-platform support.",
|
||||
"version": "1.0.3",
|
||||
"author": {
|
||||
"name": "Dev GOM",
|
||||
"url": "https://github.com/Dev-GOM/claude-code-marketplace"
|
||||
},
|
||||
"skills": [
|
||||
"./skills"
|
||||
]
|
||||
}
|
||||
3
README.md
Normal file
3
README.md
Normal file
@@ -0,0 +1,3 @@
|
||||
# auto-release-manager
|
||||
|
||||
Automate version updates and releases for any project type (Node.js, Python, Rust, Unity, Unreal, etc.) with intelligent project detection and cross-platform support.
|
||||
85
plugin.lock.json
Normal file
85
plugin.lock.json
Normal file
@@ -0,0 +1,85 @@
|
||||
{
|
||||
"$schema": "internal://schemas/plugin.lock.v1.json",
|
||||
"pluginId": "gh:Dev-GOM/claude-code-marketplace:plugins/auto-release-manager",
|
||||
"normalized": {
|
||||
"repo": null,
|
||||
"ref": "refs/tags/v20251128.0",
|
||||
"commit": "c7a9b94dd277fb271aedc0f56f97155072bf9419",
|
||||
"treeHash": "73fb86e7061159773e5f4a0f1b0b600e79d7abbf71d4fc7ce8370cce46b3f608",
|
||||
"generatedAt": "2025-11-28T10:10:17.061929Z",
|
||||
"toolVersion": "publish_plugins.py@0.2.0"
|
||||
},
|
||||
"origin": {
|
||||
"remote": "git@github.com:zhongweili/42plugin-data.git",
|
||||
"branch": "master",
|
||||
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
|
||||
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
|
||||
},
|
||||
"manifest": {
|
||||
"name": "auto-release-manager",
|
||||
"description": "Automate version updates and releases for any project type (Node.js, Python, Rust, Unity, Unreal, etc.) with intelligent project detection and cross-platform support.",
|
||||
"version": "1.0.3"
|
||||
},
|
||||
"content": {
|
||||
"files": [
|
||||
{
|
||||
"path": "README.md",
|
||||
"sha256": "a5ae49a6fe1b46791ade1d36417b65cd4137c43b06edd526bf49d99d88c5e39c"
|
||||
},
|
||||
{
|
||||
"path": ".claude-plugin/plugin.json",
|
||||
"sha256": "377857f3b2365fc23cc778325e12a27d957aae117866fd66ade504159238ce74"
|
||||
},
|
||||
{
|
||||
"path": "skills/SKILL.md",
|
||||
"sha256": "5869f71f5e65b30e9febe9ed3f3d19d107c31636b28923d45ed984c8a63c8bd6"
|
||||
},
|
||||
{
|
||||
"path": "skills/references/unreal-guide.md",
|
||||
"sha256": "b6b1d1b8980bb4aebb45395094def41254c383b27385546edf39c7a8d34ff197"
|
||||
},
|
||||
{
|
||||
"path": "skills/references/project-types.md",
|
||||
"sha256": "56641ef5cbd333d4579527386eac403d351c09572d548333f31c8a36922e7c8b"
|
||||
},
|
||||
{
|
||||
"path": "skills/references/unity-guide.md",
|
||||
"sha256": "76d90bfb9602f49bcd44e4db17933344ffb80f5b49e4d2fb855ee6560852ffe5"
|
||||
},
|
||||
{
|
||||
"path": "skills/scripts/update_version.py",
|
||||
"sha256": "74a387b76612c8f422b5897750e75d7a324eccff7f4e439eec0eafedf0daef43"
|
||||
},
|
||||
{
|
||||
"path": "skills/scripts/detect_project.py",
|
||||
"sha256": "751907737844a1a7940f8b29c2744ab9517b73e7452f437d67fd0e1d3bbf8d06"
|
||||
},
|
||||
{
|
||||
"path": "skills/scripts/sync_unity_version.py",
|
||||
"sha256": "c69cadbae7246ce82b054213c8aca2a912c2f76e73131ea1caa2e255c0491f13"
|
||||
},
|
||||
{
|
||||
"path": "skills/scripts/changelog_generator.py",
|
||||
"sha256": "a446f1c9d2ec375347468b92a2e8ef2f7eb4da573d64ac389c81bffa256b53d4"
|
||||
},
|
||||
{
|
||||
"path": "skills/scripts/git_operations.py",
|
||||
"sha256": "ee08ce54c2901a40a9e8c4cf543b739cff8138c061ef7ed332fe5a472dc339c1"
|
||||
},
|
||||
{
|
||||
"path": "skills/assets/CHANGELOG.md.template",
|
||||
"sha256": "9badb0bc8ff7cfc0948778eada3bae7c9fd55b692763dd41564b2a8c4fceb4ea"
|
||||
},
|
||||
{
|
||||
"path": "skills/assets/version.json.template",
|
||||
"sha256": "a959e111008e5a14623cce9f6e6f79915f27396b9a2096c649e87c678321fe9e"
|
||||
}
|
||||
],
|
||||
"dirSha256": "73fb86e7061159773e5f4a0f1b0b600e79d7abbf71d4fc7ce8370cce46b3f608"
|
||||
},
|
||||
"security": {
|
||||
"scannedAt": null,
|
||||
"scannerVersion": null,
|
||||
"flags": []
|
||||
}
|
||||
}
|
||||
294
skills/SKILL.md
Normal file
294
skills/SKILL.md
Normal file
@@ -0,0 +1,294 @@
|
||||
---
|
||||
name: auto-release-manager
|
||||
description: Automate version updates and releases for any project type (Node.js, Python, Rust, Unity, Unreal, etc.). Detect project type, update version files, generate CHANGELOG, and handle git operations with cross-platform support.
|
||||
allowed-tools: Bash, Read, Write
|
||||
---
|
||||
|
||||
# Auto Release Manager
|
||||
|
||||
Automate the entire release workflow for any project type with intelligent project detection and cross-platform support.
|
||||
|
||||
## Purpose
|
||||
|
||||
This skill streamlines version management across different project types by:
|
||||
- Automatically detecting project type (Node.js, Python, Rust, Unity, Unreal, etc.)
|
||||
- Updating version files in appropriate formats (JSON, TOML, YAML, Unity assets)
|
||||
- Generating CHANGELOG from git commit history
|
||||
- Handling git operations (commit, tag, push) with OS compatibility
|
||||
- Supporting game engine specific workflows (Unity version.json ← → ProjectSettings.asset sync)
|
||||
|
||||
## When to Use
|
||||
|
||||
Use this skill when:
|
||||
- Releasing a new version of any project
|
||||
- User requests "update version", "create release", "bump version"
|
||||
- Need to handle versions across multiple files (e.g., Unity's dual-file approach)
|
||||
- Want automated CHANGELOG generation from commits
|
||||
- Working with game engine projects (Unity, Unreal)
|
||||
|
||||
Example user requests:
|
||||
- "Bump patch version and create release"
|
||||
- "Update to v2.1.0"
|
||||
- "Create Unity release with version 1.5.0"
|
||||
- "Generate CHANGELOG and commit"
|
||||
|
||||
## Workflow
|
||||
|
||||
### Step 1: Detect Project Type
|
||||
|
||||
Start by running the project detection script to identify the project type and version files:
|
||||
|
||||
```bash
|
||||
python -X utf8 scripts/detect_project.py .
|
||||
```
|
||||
|
||||
The script returns JSON with:
|
||||
```json
|
||||
{
|
||||
"project_type": "unity",
|
||||
"version_files": [
|
||||
"version.json",
|
||||
"ProjectSettings/ProjectSettings.asset"
|
||||
],
|
||||
"detected_version": "1.2.3"
|
||||
}
|
||||
```
|
||||
|
||||
Supported project types:
|
||||
- `nodejs` - Node.js (package.json)
|
||||
- `python` - Python (pyproject.toml, setup.py)
|
||||
- `rust` - Rust (Cargo.toml)
|
||||
- `go` - Go (VERSION file)
|
||||
- `unity` - Unity (version.json + ProjectSettings.asset)
|
||||
- `unreal` - Unreal Engine (.uproject)
|
||||
- `claude-plugin` - Claude Code Plugin (plugin.json)
|
||||
- `generic` - Generic project (VERSION file)
|
||||
|
||||
### Step 2: Determine New Version
|
||||
|
||||
Calculate the new version based on update type:
|
||||
|
||||
**Semantic Versioning (MAJOR.MINOR.PATCH):**
|
||||
- **PATCH** (x.x.X): Bug fixes
|
||||
- **MINOR** (x.X.0): New features (backward compatible)
|
||||
- **MAJOR** (X.0.0): Breaking changes
|
||||
|
||||
Examples:
|
||||
- 1.2.3 → 1.2.4 (patch)
|
||||
- 1.2.3 → 1.3.0 (minor)
|
||||
- 1.2.3 → 2.0.0 (major)
|
||||
|
||||
If user specifies version directly (e.g., "v2.1.0"), use that version.
|
||||
|
||||
### Step 3: Update Version Files
|
||||
|
||||
Use the universal version updater to update all detected files:
|
||||
|
||||
```bash
|
||||
python -X utf8 scripts/update_version.py <file1> <file2> ... <new_version>
|
||||
```
|
||||
|
||||
Example for Node.js:
|
||||
```bash
|
||||
python -X utf8 scripts/update_version.py package.json 1.3.0
|
||||
```
|
||||
|
||||
Example for Unity (multiple files):
|
||||
```bash
|
||||
python -X utf8 scripts/update_version.py version.json ProjectSettings/ProjectSettings.asset 1.3.0
|
||||
```
|
||||
|
||||
**Unity-specific:** After updating version.json, sync to ProjectSettings.asset:
|
||||
```bash
|
||||
python -X utf8 scripts/sync_unity_version.py
|
||||
```
|
||||
|
||||
This ensures version.json is the single source of truth.
|
||||
|
||||
### Step 4: Generate CHANGELOG (Optional)
|
||||
|
||||
If user wants CHANGELOG updates or it's part of the workflow:
|
||||
|
||||
```bash
|
||||
python -X utf8 scripts/changelog_generator.py <new_version> [since_tag] [changelog_path]
|
||||
```
|
||||
|
||||
Examples:
|
||||
```bash
|
||||
# Generate from last tag to HEAD
|
||||
python -X utf8 scripts/changelog_generator.py 1.3.0 v1.2.3
|
||||
|
||||
# Generate from all commits
|
||||
python -X utf8 scripts/changelog_generator.py 1.3.0
|
||||
|
||||
# Custom CHANGELOG path
|
||||
python -X utf8 scripts/changelog_generator.py 1.3.0 v1.2.3 CHANGELOG.ko.md
|
||||
```
|
||||
|
||||
The script parses Conventional Commits and groups by type:
|
||||
- `feat:` → Added
|
||||
- `fix:` → Fixed
|
||||
- `refactor:` → Changed
|
||||
- `docs:` → Documentation
|
||||
|
||||
### Step 5: Git Operations
|
||||
|
||||
Ask user which git operations to perform using AskUserQuestion tool:
|
||||
|
||||
**Tool constraints:**
|
||||
- Header: "Git 작업" (6 characters ✅)
|
||||
- Options: 3 options (within 2-4 range ✅)
|
||||
- multiSelect: false
|
||||
|
||||
**Options:**
|
||||
|
||||
1. **"커밋만"** (label: 2 words ✅)
|
||||
- Description: "버전 업데이트를 커밋만 합니다. 태그와 푸시는 나중에 직접 처리하겠습니다."
|
||||
- Action: Commit only
|
||||
|
||||
2. **"커밋+태그"** (label: 2 words ✅)
|
||||
- Description: "커밋과 태그를 생성합니다. 푸시는 나중에 직접 하겠습니다."
|
||||
- Action: Commit + Create tag
|
||||
|
||||
3. **"전체"** (label: 1 word ✅)
|
||||
- Description: "커밋, 태그 생성, 푸시까지 모든 작업을 자동으로 처리합니다. (권장)"
|
||||
- Action: Commit + Tag + Push
|
||||
|
||||
Based on user selection:
|
||||
|
||||
**Commit:**
|
||||
```bash
|
||||
python -X utf8 scripts/git_operations.py commit "chore: bump version to <VERSION>
|
||||
|
||||
Version updates:
|
||||
- Updated <files> to <VERSION>
|
||||
|
||||
🤖 Generated with Claude Code
|
||||
Co-Authored-By: Claude <noreply@anthropic.com>"
|
||||
```
|
||||
|
||||
**Create Tag:**
|
||||
```bash
|
||||
python -X utf8 scripts/git_operations.py tag v<VERSION> "Release v<VERSION>"
|
||||
```
|
||||
|
||||
**Push (branch + tags):**
|
||||
```bash
|
||||
python -X utf8 scripts/git_operations.py push
|
||||
python -X utf8 scripts/git_operations.py push-tags
|
||||
```
|
||||
|
||||
### Step 6: GitHub Release (Optional)
|
||||
|
||||
If user wants GitHub release, use `gh` CLI:
|
||||
|
||||
```bash
|
||||
gh release create v<VERSION> \
|
||||
--title "v<VERSION> - <Title>" \
|
||||
--notes "<Release notes from CHANGELOG>"
|
||||
```
|
||||
|
||||
## Project-Specific Workflows
|
||||
|
||||
### Unity Workflow
|
||||
|
||||
Unity projects require special handling due to dual-file approach:
|
||||
|
||||
1. Detect Unity project (ProjectSettings.asset exists)
|
||||
2. Update version.json first (source of truth)
|
||||
3. Sync to ProjectSettings.asset using sync_unity_version.py
|
||||
4. Commit both files together
|
||||
5. Tag and push
|
||||
|
||||
Reference: `references/unity-guide.md` for detailed Unity workflow.
|
||||
|
||||
### Unreal Workflow
|
||||
|
||||
Unreal projects use .uproject JSON file:
|
||||
|
||||
1. Detect .uproject file
|
||||
2. Update Version field in .uproject
|
||||
3. Optionally sync to Config/DefaultGame.ini
|
||||
4. Commit, tag, push
|
||||
|
||||
Reference: `references/unreal-guide.md` for detailed Unreal workflow.
|
||||
|
||||
### Node.js / Python / Rust Workflow
|
||||
|
||||
Standard workflow for web/backend projects:
|
||||
|
||||
1. Detect project type via package file
|
||||
2. Update version field in package file
|
||||
3. Generate CHANGELOG from commits
|
||||
4. Commit, tag, push
|
||||
|
||||
## Error Handling
|
||||
|
||||
Handle common errors:
|
||||
|
||||
**Project not detected:**
|
||||
- Check if running in correct directory
|
||||
- Look for .git directory
|
||||
- Suggest creating VERSION file for generic projects
|
||||
|
||||
**Version file not found:**
|
||||
- Suggest creating file from template (assets/)
|
||||
- For Unity: Create version.json from template
|
||||
|
||||
**Git errors:**
|
||||
- Check if git repository exists
|
||||
- Verify remote is configured
|
||||
- Handle authentication issues
|
||||
|
||||
**Script errors:**
|
||||
- Ensure Python 3.11+ is installed
|
||||
- Check file permissions
|
||||
- Verify file encodings (UTF-8)
|
||||
|
||||
## Bundled Resources
|
||||
|
||||
### Scripts
|
||||
|
||||
All scripts are in `scripts/` directory and work cross-platform (Windows, macOS, Linux):
|
||||
|
||||
- **detect_project.py**: Auto-detect project type
|
||||
- **update_version.py**: Universal version updater
|
||||
- **sync_unity_version.py**: Unity version synchronization
|
||||
- **git_operations.py**: Git workflow automation
|
||||
- **changelog_generator.py**: CHANGELOG generation
|
||||
|
||||
### References
|
||||
|
||||
Detailed guides in `references/` directory:
|
||||
|
||||
- **project-types.md**: All supported project types and version file locations
|
||||
- **unity-guide.md**: Unity-specific version management
|
||||
- **unreal-guide.md**: Unreal Engine version management
|
||||
|
||||
Load these as needed for detailed information.
|
||||
|
||||
### Assets
|
||||
|
||||
Templates in `assets/` directory:
|
||||
|
||||
- **version.json.template**: Template for Unity/game projects
|
||||
- **CHANGELOG.md.template**: Template for new CHANGELOG files
|
||||
|
||||
Use these when creating new version files.
|
||||
|
||||
## Best Practices
|
||||
|
||||
- Always commit version files together (e.g., Unity's version.json + ProjectSettings.asset)
|
||||
- Use semantic versioning consistently
|
||||
- Write meaningful commit messages following Conventional Commits
|
||||
- Tag releases with `v` prefix (e.g., v1.2.3)
|
||||
- Keep CHANGELOG updated for user-facing changes
|
||||
- For Unity: version.json is source of truth, always sync to ProjectSettings.asset
|
||||
|
||||
## Notes
|
||||
|
||||
- Scripts use Python 3.11+ with only stdlib dependencies
|
||||
- All file operations use UTF-8 encoding
|
||||
- Path handling uses pathlib for cross-platform compatibility
|
||||
- Git operations use subprocess for reliability
|
||||
- Unity YAML parsing uses regex for robustness
|
||||
16
skills/assets/CHANGELOG.md.template
Normal file
16
skills/assets/CHANGELOG.md.template
Normal file
@@ -0,0 +1,16 @@
|
||||
# Changelog
|
||||
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
### Added
|
||||
- Initial project setup
|
||||
|
||||
## [0.1.0] - 2025-11-01
|
||||
|
||||
### Added
|
||||
- First release
|
||||
6
skills/assets/version.json.template
Normal file
6
skills/assets/version.json.template
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"version": "0.1.0",
|
||||
"buildNumber": 1,
|
||||
"releaseDate": "2025-11-01",
|
||||
"releaseNotes": "Initial release"
|
||||
}
|
||||
160
skills/references/project-types.md
Normal file
160
skills/references/project-types.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# Supported Project Types
|
||||
|
||||
This document describes all project types supported by auto-release-manager and their version file locations.
|
||||
|
||||
## Web & Backend
|
||||
|
||||
### Node.js
|
||||
- **Detection file**: `package.json`
|
||||
- **Version location**: `package.json` → `version` field
|
||||
- **Format**: JSON
|
||||
- **Example**:
|
||||
```json
|
||||
{
|
||||
"name": "my-project",
|
||||
"version": "1.2.3"
|
||||
}
|
||||
```
|
||||
|
||||
### Python
|
||||
- **Detection files**: `pyproject.toml` or `setup.py`
|
||||
- **Version location**:
|
||||
- `pyproject.toml` → `project.version` or `tool.poetry.version`
|
||||
- `setup.py` → `version=` parameter
|
||||
- **Format**: TOML or Python
|
||||
- **Example**:
|
||||
```toml
|
||||
[project]
|
||||
name = "my-project"
|
||||
version = "1.2.3"
|
||||
```
|
||||
|
||||
### Rust
|
||||
- **Detection file**: `Cargo.toml`
|
||||
- **Version location**: `Cargo.toml` → `package.version`
|
||||
- **Format**: TOML
|
||||
- **Example**:
|
||||
```toml
|
||||
[package]
|
||||
name = "my-project"
|
||||
version = "1.2.3"
|
||||
```
|
||||
|
||||
### Go
|
||||
- **Detection file**: `go.mod`
|
||||
- **Version location**: `VERSION` file (custom)
|
||||
- **Format**: Plain text
|
||||
- **Note**: Go doesn't have built-in versioning in go.mod
|
||||
|
||||
## Game Engines
|
||||
|
||||
### Unity
|
||||
- **Detection file**: `ProjectSettings/ProjectSettings.asset`
|
||||
- **Version locations**:
|
||||
1. `version.json` (Primary source of truth) → `version` field
|
||||
2. `ProjectSettings/ProjectSettings.asset` → `bundleVersion` field
|
||||
- **Format**: JSON + Unity YAML
|
||||
- **Workflow**: Update `version.json` first, then sync to `ProjectSettings.asset`
|
||||
- **Example**:
|
||||
|
||||
`version.json`:
|
||||
```json
|
||||
{
|
||||
"version": "1.2.3",
|
||||
"buildNumber": 42
|
||||
}
|
||||
```
|
||||
|
||||
`ProjectSettings.asset`:
|
||||
```yaml
|
||||
PlayerSettings:
|
||||
bundleVersion: 1.2.3
|
||||
```
|
||||
|
||||
### Unreal Engine
|
||||
- **Detection file**: `*.uproject`
|
||||
- **Version location**: `<ProjectName>.uproject` → `Version` or `EngineAssociation`
|
||||
- **Format**: JSON
|
||||
- **Example**:
|
||||
```json
|
||||
{
|
||||
"FileVersion": 3,
|
||||
"EngineAssociation": "5.3",
|
||||
"Version": "1.2.3"
|
||||
}
|
||||
```
|
||||
|
||||
### Godot
|
||||
- **Detection file**: `project.godot`
|
||||
- **Version location**: `project.godot` → `config/version`
|
||||
- **Format**: INI-like
|
||||
- **Example**:
|
||||
```ini
|
||||
[application]
|
||||
config/name="MyGame"
|
||||
config/version="1.2.3"
|
||||
```
|
||||
|
||||
## Plugins & Extensions
|
||||
|
||||
### Claude Code Plugin
|
||||
- **Detection file**: `.claude-plugin/plugin.json`
|
||||
- **Version location**: `.claude-plugin/plugin.json` → `version`
|
||||
- **Format**: JSON
|
||||
- **Example**:
|
||||
```json
|
||||
{
|
||||
"name": "my-plugin",
|
||||
"version": "1.2.3",
|
||||
"description": "..."
|
||||
}
|
||||
```
|
||||
|
||||
### VS Code Extension
|
||||
- **Detection file**: `package.json` + `package.nls.json`
|
||||
- **Version location**: `package.json` → `version`
|
||||
- **Format**: JSON
|
||||
- **Same as Node.js projects**
|
||||
|
||||
### Browser Extension
|
||||
- **Detection file**: `manifest.json`
|
||||
- **Version location**: `manifest.json` → `version`
|
||||
- **Format**: JSON
|
||||
- **Example**:
|
||||
```json
|
||||
{
|
||||
"manifest_version": 3,
|
||||
"name": "My Extension",
|
||||
"version": "1.2.3"
|
||||
}
|
||||
```
|
||||
|
||||
## Generic Projects
|
||||
|
||||
### Plain VERSION file
|
||||
- **Detection file**: `VERSION` or `version.txt`
|
||||
- **Version location**: Content of file
|
||||
- **Format**: Plain text
|
||||
- **Example**:
|
||||
```
|
||||
1.2.3
|
||||
```
|
||||
|
||||
## Version Format
|
||||
|
||||
All projects follow **Semantic Versioning (semver)**:
|
||||
|
||||
```
|
||||
MAJOR.MINOR.PATCH
|
||||
|
||||
1.2.3
|
||||
│ │ │
|
||||
│ │ └─ PATCH: Bug fixes
|
||||
│ └─── MINOR: New features (backward compatible)
|
||||
└───── MAJOR: Breaking changes
|
||||
```
|
||||
|
||||
Examples:
|
||||
- `1.0.0` → `1.0.1` (patch: bug fix)
|
||||
- `1.0.1` → `1.1.0` (minor: new feature)
|
||||
- `1.1.0` → `2.0.0` (major: breaking change)
|
||||
140
skills/references/unity-guide.md
Normal file
140
skills/references/unity-guide.md
Normal file
@@ -0,0 +1,140 @@
|
||||
# Unity Project Version Management
|
||||
|
||||
## Overview
|
||||
|
||||
Unity projects use a dual-file approach for version management:
|
||||
1. **`version.json`** - Single source of truth (easy to read/edit)
|
||||
2. **`ProjectSettings/ProjectSettings.asset`** - Auto-synced (used by Unity builds)
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
MyUnityProject/
|
||||
├── version.json # Primary source
|
||||
├── ProjectSettings/
|
||||
│ └── ProjectSettings.asset # Auto-synced
|
||||
└── Assets/
|
||||
└── ...
|
||||
```
|
||||
|
||||
## version.json (Primary)
|
||||
|
||||
Create this file at project root:
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1.2.3",
|
||||
"buildNumber": 42,
|
||||
"releaseDate": "2025-10-20"
|
||||
}
|
||||
```
|
||||
|
||||
**Fields:**
|
||||
- `version` (required): Semantic version (MAJOR.MINOR.PATCH)
|
||||
- `buildNumber` (optional): Incremental build number
|
||||
- `releaseDate` (optional): Release date in YYYY-MM-DD format
|
||||
|
||||
## ProjectSettings.asset (Auto-sync)
|
||||
|
||||
The `bundleVersion` field in this file is automatically synced from `version.json`:
|
||||
|
||||
```yaml
|
||||
PlayerSettings:
|
||||
bundleVersion: 1.2.3
|
||||
AndroidBundleVersionCode: 42
|
||||
buildNumber:
|
||||
iOS: 42
|
||||
```
|
||||
|
||||
## Workflow
|
||||
|
||||
### Manual Update
|
||||
|
||||
1. Edit `version.json`:
|
||||
```json
|
||||
{
|
||||
"version": "1.3.0"
|
||||
}
|
||||
```
|
||||
|
||||
2. Run sync script:
|
||||
```bash
|
||||
python scripts/sync_unity_version.py
|
||||
```
|
||||
|
||||
3. Commit both files:
|
||||
```bash
|
||||
git add version.json ProjectSettings/ProjectSettings.asset
|
||||
git commit -m "chore: bump version to 1.3.0"
|
||||
```
|
||||
|
||||
### Automatic Update (with auto-release-manager)
|
||||
|
||||
The skill handles everything automatically:
|
||||
|
||||
```
|
||||
1. Update version.json → 1.3.0
|
||||
2. Sync to ProjectSettings.asset
|
||||
3. Git commit both files
|
||||
4. Create tag v1.3.0
|
||||
5. Push to remote
|
||||
```
|
||||
|
||||
## Benefits of Dual-File Approach
|
||||
|
||||
✅ **Easy Version Management**
|
||||
- `version.json` is simple JSON, easy to read/edit
|
||||
- Clean git diffs
|
||||
|
||||
✅ **Unity Integration**
|
||||
- `ProjectSettings.asset` is used by Unity builds
|
||||
- Version automatically appears in build
|
||||
|
||||
✅ **Automated Sync**
|
||||
- Scripts ensure consistency
|
||||
- No manual errors
|
||||
|
||||
✅ **Extended Metadata**
|
||||
- `version.json` can store additional info (buildNumber, releaseDate)
|
||||
- `ProjectSettings.asset` only has bundleVersion
|
||||
|
||||
## Common Issues
|
||||
|
||||
### Q: Why not just use ProjectSettings.asset?
|
||||
|
||||
A: ProjectSettings.asset is a YAML file that's hard to read and edit manually. It also contains hundreds of other settings, making git diffs noisy.
|
||||
|
||||
### Q: Can I use only version.json?
|
||||
|
||||
A: No. Unity reads bundleVersion from ProjectSettings.asset for builds. Both files are needed.
|
||||
|
||||
### Q: What if files get out of sync?
|
||||
|
||||
A: Run `python scripts/sync_unity_version.py` to sync from version.json (source of truth) to ProjectSettings.asset.
|
||||
|
||||
## Example: Version Update
|
||||
|
||||
**Before:**
|
||||
```json
|
||||
// version.json
|
||||
{
|
||||
"version": "1.2.3",
|
||||
"buildNumber": 42
|
||||
}
|
||||
```
|
||||
|
||||
**After:**
|
||||
```json
|
||||
// version.json
|
||||
{
|
||||
"version": "1.3.0",
|
||||
"buildNumber": 43
|
||||
}
|
||||
```
|
||||
|
||||
**Auto-synced:**
|
||||
```yaml
|
||||
# ProjectSettings.asset
|
||||
PlayerSettings:
|
||||
bundleVersion: 1.3.0 # ← Automatically updated
|
||||
```
|
||||
152
skills/references/unreal-guide.md
Normal file
152
skills/references/unreal-guide.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# Unreal Engine Project Version Management
|
||||
|
||||
## Overview
|
||||
|
||||
Unreal Engine projects use `.uproject` JSON file for project configuration and versioning.
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
MyUnrealProject/
|
||||
├── MyGame.uproject # Project file with version
|
||||
├── Config/
|
||||
│ └── DefaultGame.ini # Game config
|
||||
├── Source/
|
||||
│ └── ...
|
||||
└── Content/
|
||||
└── ...
|
||||
```
|
||||
|
||||
## .uproject File
|
||||
|
||||
The project file is a JSON file containing project metadata:
|
||||
|
||||
```json
|
||||
{
|
||||
"FileVersion": 3,
|
||||
"EngineAssociation": "5.3",
|
||||
"Category": "",
|
||||
"Description": "",
|
||||
"Version": "1.2.3",
|
||||
"Modules": [
|
||||
{
|
||||
"Name": "MyGame",
|
||||
"Type": "Runtime",
|
||||
"LoadingPhase": "Default"
|
||||
}
|
||||
],
|
||||
"Plugins": [
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Version Fields:**
|
||||
- `Version` (custom): Semantic version of your project
|
||||
- `EngineAssociation`: Unreal Engine version (e.g., "5.3", "5.4")
|
||||
|
||||
## Version Update Workflow
|
||||
|
||||
### Manual Update
|
||||
|
||||
1. Edit `.uproject` file:
|
||||
```json
|
||||
{
|
||||
"Version": "1.3.0"
|
||||
}
|
||||
```
|
||||
|
||||
2. Commit:
|
||||
```bash
|
||||
git add MyGame.uproject
|
||||
git commit -m "chore: bump version to 1.3.0"
|
||||
```
|
||||
|
||||
### Automatic Update (with auto-release-manager)
|
||||
|
||||
```
|
||||
1. Detect .uproject file
|
||||
2. Update Version field → 1.3.0
|
||||
3. Git commit
|
||||
4. Create tag v1.3.0
|
||||
5. Push to remote
|
||||
```
|
||||
|
||||
## DefaultGame.ini
|
||||
|
||||
Optional: You can also store version in `Config/DefaultGame.ini`:
|
||||
|
||||
```ini
|
||||
[/Script/EngineSettings.GeneralProjectSettings]
|
||||
ProjectID=...
|
||||
ProjectName=MyGame
|
||||
ProjectVersion=1.2.3
|
||||
CompanyName=MyCompany
|
||||
```
|
||||
|
||||
This is useful for in-game version display.
|
||||
|
||||
## Build Versioning
|
||||
|
||||
For packaging builds, you may want to configure:
|
||||
|
||||
**Config/DefaultGame.ini:**
|
||||
```ini
|
||||
[/Script/UnrealEd.ProjectPackagingSettings]
|
||||
BuildConfiguration=PPBC_Shipping
|
||||
ProjectVersion=1.2.3
|
||||
```
|
||||
|
||||
## Example: Full Update
|
||||
|
||||
When updating version from 1.2.3 to 1.3.0:
|
||||
|
||||
**Files to update:**
|
||||
1. `MyGame.uproject` → `Version: "1.3.0"`
|
||||
2. `Config/DefaultGame.ini` → `ProjectVersion=1.3.0` (if used)
|
||||
|
||||
**auto-release-manager handles:**
|
||||
- Detecting .uproject file
|
||||
- Updating Version field
|
||||
- Git commit + tag
|
||||
- Push to remote
|
||||
|
||||
## Common Issues
|
||||
|
||||
### Q: Is Version field required in .uproject?
|
||||
|
||||
A: No, it's optional. But recommended for version tracking.
|
||||
|
||||
### Q: What about EngineAssociation?
|
||||
|
||||
A: EngineAssociation is the UE version (e.g., "5.3"). Don't confuse it with your project version.
|
||||
|
||||
### Q: Can I use multiple version fields?
|
||||
|
||||
A: Yes! You can maintain:
|
||||
- `.uproject` → Version (project version)
|
||||
- `DefaultGame.ini` → ProjectVersion (in-game display)
|
||||
- `version.json` → Custom metadata
|
||||
|
||||
Just ensure they stay synced.
|
||||
|
||||
## Recommended Approach
|
||||
|
||||
**Best Practice:**
|
||||
1. Use `.uproject` → Version as primary
|
||||
2. Optionally sync to `DefaultGame.ini` for in-game display
|
||||
3. Use auto-release-manager to keep everything consistent
|
||||
|
||||
**Example:**
|
||||
```json
|
||||
// MyGame.uproject
|
||||
{
|
||||
"Version": "1.3.0"
|
||||
}
|
||||
```
|
||||
|
||||
```ini
|
||||
; Config/DefaultGame.ini
|
||||
[/Script/EngineSettings.GeneralProjectSettings]
|
||||
ProjectVersion=1.3.0
|
||||
```
|
||||
205
skills/scripts/changelog_generator.py
Normal file
205
skills/scripts/changelog_generator.py
Normal file
@@ -0,0 +1,205 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
CHANGELOG generator from git commit history.
|
||||
Supports Conventional Commits format.
|
||||
"""
|
||||
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
from typing import List, Dict, Optional
|
||||
|
||||
|
||||
class ChangelogGenerator:
|
||||
def __init__(self, repo_path: str = "."):
|
||||
self.repo_path = Path(repo_path).resolve()
|
||||
|
||||
# Conventional Commits types
|
||||
self.commit_types = {
|
||||
'feat': 'Added',
|
||||
'fix': 'Fixed',
|
||||
'docs': 'Documentation',
|
||||
'style': 'Style',
|
||||
'refactor': 'Changed',
|
||||
'perf': 'Performance',
|
||||
'test': 'Tests',
|
||||
'chore': 'Chore',
|
||||
'build': 'Build',
|
||||
'ci': 'CI/CD',
|
||||
}
|
||||
|
||||
def get_commits_since_tag(
|
||||
self,
|
||||
since_tag: Optional[str] = None) -> List[str]:
|
||||
"""Get commit messages since last tag."""
|
||||
try:
|
||||
if since_tag:
|
||||
cmd = [
|
||||
'git',
|
||||
'log',
|
||||
f'{since_tag}..HEAD',
|
||||
'--pretty=format:%s']
|
||||
else:
|
||||
# Get all commits if no tag specified
|
||||
cmd = ['git', 'log', '--pretty=format:%s']
|
||||
|
||||
result = subprocess.run(
|
||||
cmd,
|
||||
cwd=self.repo_path,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=True,
|
||||
encoding='utf-8'
|
||||
)
|
||||
|
||||
return (
|
||||
result.stdout.strip().split('\n')
|
||||
if result.stdout.strip() else []
|
||||
)
|
||||
|
||||
except subprocess.CalledProcessError as e:
|
||||
print(f"Error getting git commits: {e.stderr}", file=sys.stderr)
|
||||
return []
|
||||
|
||||
def parse_commit(self, commit_message: str) -> Dict[str, str]:
|
||||
"""Parse conventional commit message."""
|
||||
# Pattern: type(scope): description
|
||||
pattern = r'^(\w+)(?:\(([^)]+)\))?: (.+)$'
|
||||
match = re.match(pattern, commit_message)
|
||||
|
||||
if match:
|
||||
commit_type, scope, description = match.groups()
|
||||
return {
|
||||
'type': commit_type,
|
||||
'scope': scope or '',
|
||||
'description': description,
|
||||
'raw': commit_message
|
||||
}
|
||||
else:
|
||||
return {
|
||||
'type': 'other',
|
||||
'scope': '',
|
||||
'description': commit_message,
|
||||
'raw': commit_message
|
||||
}
|
||||
|
||||
def group_commits(self, commits: List[str]) -> Dict[str, List[str]]:
|
||||
"""Group commits by type."""
|
||||
grouped: Dict[str, List[str]] = {}
|
||||
|
||||
for commit_msg in commits:
|
||||
parsed = self.parse_commit(commit_msg)
|
||||
commit_type = parsed['type']
|
||||
description = parsed['description']
|
||||
|
||||
category = self.commit_types.get(commit_type, 'Other')
|
||||
|
||||
if category not in grouped:
|
||||
grouped[category] = []
|
||||
|
||||
grouped[category].append(description)
|
||||
|
||||
return grouped
|
||||
|
||||
def generate_changelog_entry(
|
||||
self,
|
||||
version: str,
|
||||
since_tag: Optional[str] = None) -> str:
|
||||
"""Generate changelog entry for new version."""
|
||||
commits = self.get_commits_since_tag(since_tag)
|
||||
|
||||
if not commits:
|
||||
print("No commits found", file=sys.stderr)
|
||||
return ""
|
||||
|
||||
grouped = self.group_commits(commits)
|
||||
|
||||
# Build changelog entry
|
||||
date = datetime.now().strftime('%Y-%m-%d')
|
||||
lines = [
|
||||
f"## [{version}] - {date}",
|
||||
""
|
||||
]
|
||||
|
||||
# Add sections in order
|
||||
section_order = [
|
||||
'Added', 'Fixed', 'Changed', 'Deprecated', 'Removed',
|
||||
'Security', 'Performance', 'Documentation', 'Other'
|
||||
]
|
||||
|
||||
for section in section_order:
|
||||
if section in grouped:
|
||||
lines.append(f"### {section}")
|
||||
for item in grouped[section]:
|
||||
lines.append(f"- {item}")
|
||||
lines.append("")
|
||||
|
||||
return '\n'.join(lines)
|
||||
|
||||
def update_changelog_file(
|
||||
self,
|
||||
version: str,
|
||||
since_tag: Optional[str] = None,
|
||||
changelog_path: str = "CHANGELOG.md"
|
||||
) -> bool:
|
||||
"""Update CHANGELOG.md file with new entry."""
|
||||
entry = self.generate_changelog_entry(version, since_tag)
|
||||
|
||||
if not entry:
|
||||
return False
|
||||
|
||||
changelog_file = self.repo_path / changelog_path
|
||||
|
||||
if changelog_file.exists():
|
||||
# Insert at top after header
|
||||
content = changelog_file.read_text(encoding='utf-8')
|
||||
|
||||
# Find position to insert (after # Changelog header)
|
||||
lines = content.split('\n')
|
||||
insert_pos = 0
|
||||
|
||||
for i, line in enumerate(lines):
|
||||
if line.startswith('# '):
|
||||
insert_pos = i + 1
|
||||
# Skip empty lines after header
|
||||
while (insert_pos < len(lines) and
|
||||
not lines[insert_pos].strip()):
|
||||
insert_pos += 1
|
||||
break
|
||||
|
||||
lines.insert(insert_pos, entry)
|
||||
new_content = '\n'.join(lines)
|
||||
|
||||
else:
|
||||
# Create new CHANGELOG
|
||||
new_content = f"# Changelog\n\n{entry}"
|
||||
|
||||
changelog_file.write_text(new_content, encoding='utf-8')
|
||||
print(f"✓ Updated {changelog_path}")
|
||||
|
||||
return True
|
||||
|
||||
|
||||
def main():
|
||||
if len(sys.argv) < 2:
|
||||
print(
|
||||
"Usage: python changelog_generator.py "
|
||||
"<version> [since_tag] [changelog_path]",
|
||||
file=sys.stderr
|
||||
)
|
||||
sys.exit(1)
|
||||
|
||||
version = sys.argv[1]
|
||||
since_tag = sys.argv[2] if len(sys.argv) > 2 else None
|
||||
changelog_path = sys.argv[3] if len(sys.argv) > 3 else "CHANGELOG.md"
|
||||
|
||||
generator = ChangelogGenerator()
|
||||
|
||||
if not generator.update_changelog_file(version, since_tag, changelog_path):
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
281
skills/scripts/detect_project.py
Normal file
281
skills/scripts/detect_project.py
Normal file
@@ -0,0 +1,281 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Detect project type and version files automatically.
|
||||
Supports: Node.js, Python, Rust, Go, Unity, Unreal Engine,
|
||||
Claude Code Plugins, etc.
|
||||
"""
|
||||
|
||||
import json
|
||||
import sys
|
||||
import tomllib # Python 3.11+ required
|
||||
from pathlib import Path
|
||||
from typing import Any, Dict, Optional
|
||||
|
||||
# Check Python version
|
||||
if sys.version_info < (3, 11):
|
||||
print(
|
||||
"Error: Python 3.11+ is required for this script",
|
||||
file=sys.stderr
|
||||
)
|
||||
print(
|
||||
"Current version: "
|
||||
f"{sys.version_info.major}.{sys.version_info.minor}",
|
||||
file=sys.stderr
|
||||
)
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
class ProjectDetector:
|
||||
def __init__(self, project_root: str = "."):
|
||||
self.root = Path(project_root).resolve()
|
||||
|
||||
def detect(self) -> Dict[str, Any]:
|
||||
"""Detect project type and return version file paths."""
|
||||
result: Dict[str, Any] = {
|
||||
"project_type": None,
|
||||
"version_files": [],
|
||||
"detected_version": None
|
||||
}
|
||||
|
||||
# Check in priority order
|
||||
detectors = [
|
||||
self._detect_unity,
|
||||
self._detect_unreal,
|
||||
self._detect_nodejs,
|
||||
self._detect_python,
|
||||
self._detect_rust,
|
||||
self._detect_go,
|
||||
self._detect_claude_plugin,
|
||||
self._detect_generic
|
||||
]
|
||||
|
||||
for detector in detectors:
|
||||
detection = detector()
|
||||
if detection:
|
||||
result.update(detection)
|
||||
break
|
||||
|
||||
return result
|
||||
|
||||
def _detect_unity(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Unity project."""
|
||||
project_settings = (
|
||||
self.root / "ProjectSettings" / "ProjectSettings.asset"
|
||||
)
|
||||
version_json = self.root / "version.json"
|
||||
|
||||
if project_settings.exists():
|
||||
files = [str(project_settings)]
|
||||
if version_json.exists():
|
||||
files.append(str(version_json))
|
||||
|
||||
# Try to read version from version.json first
|
||||
version = None
|
||||
if version_json.exists():
|
||||
try:
|
||||
data = json.loads(
|
||||
version_json.read_text(encoding='utf-8')
|
||||
)
|
||||
version = data.get('version')
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# Fallback to ProjectSettings.asset
|
||||
if not version:
|
||||
try:
|
||||
content = project_settings.read_text(
|
||||
encoding='utf-8'
|
||||
)
|
||||
for line in content.split('\n'):
|
||||
if 'bundleVersion:' in line:
|
||||
version = line.split(':', 1)[1].strip()
|
||||
break
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "unity",
|
||||
"version_files": files,
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_unreal(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Unreal Engine project."""
|
||||
uproject_files = list(self.root.glob("*.uproject"))
|
||||
|
||||
if uproject_files:
|
||||
uproject = uproject_files[0]
|
||||
version = None
|
||||
|
||||
try:
|
||||
data = json.loads(uproject.read_text(encoding='utf-8'))
|
||||
version = data.get('Version') or data.get('EngineAssociation')
|
||||
except (json.JSONDecodeError, IOError, UnicodeDecodeError):
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "unreal",
|
||||
"version_files": [str(uproject)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_nodejs(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Node.js project."""
|
||||
package_json = self.root / "package.json"
|
||||
|
||||
if package_json.exists():
|
||||
version = None
|
||||
|
||||
try:
|
||||
data = json.loads(package_json.read_text(encoding='utf-8'))
|
||||
version = data.get('version')
|
||||
except BaseException:
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "nodejs",
|
||||
"version_files": [str(package_json)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_python(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Python project."""
|
||||
pyproject = self.root / "pyproject.toml"
|
||||
setup_py = self.root / "setup.py"
|
||||
|
||||
if pyproject.exists():
|
||||
version = None
|
||||
|
||||
if tomllib:
|
||||
try:
|
||||
data = tomllib.loads(
|
||||
pyproject.read_text(encoding='utf-8')
|
||||
)
|
||||
version = (
|
||||
data.get('project', {}).get('version') or
|
||||
data.get('tool', {}).get('poetry', {}).get('version')
|
||||
)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "python",
|
||||
"version_files": [str(pyproject)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
elif setup_py.exists():
|
||||
return {
|
||||
"project_type": "python",
|
||||
"version_files": [str(setup_py)],
|
||||
"detected_version": None # Requires parsing Python
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_rust(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Rust project."""
|
||||
cargo_toml = self.root / "Cargo.toml"
|
||||
|
||||
if cargo_toml.exists():
|
||||
version = None
|
||||
|
||||
if tomllib:
|
||||
try:
|
||||
data = tomllib.loads(
|
||||
cargo_toml.read_text(
|
||||
encoding='utf-8'))
|
||||
version = data.get('package', {}).get('version')
|
||||
except BaseException:
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "rust",
|
||||
"version_files": [str(cargo_toml)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_go(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Go project."""
|
||||
go_mod = self.root / "go.mod"
|
||||
|
||||
if go_mod.exists():
|
||||
# Go doesn't have built-in versioning in go.mod
|
||||
# Check for common version files
|
||||
version_file = self.root / "VERSION"
|
||||
|
||||
if version_file.exists():
|
||||
version = version_file.read_text().strip()
|
||||
return {
|
||||
"project_type": "go",
|
||||
"version_files": [str(version_file)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return {
|
||||
"project_type": "go",
|
||||
"version_files": [],
|
||||
"detected_version": None
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_claude_plugin(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect Claude Code plugin."""
|
||||
plugin_json = self.root / ".claude-plugin" / "plugin.json"
|
||||
|
||||
if plugin_json.exists():
|
||||
version = None
|
||||
|
||||
try:
|
||||
data = json.loads(plugin_json.read_text(encoding='utf-8'))
|
||||
version = data.get('version')
|
||||
except BaseException:
|
||||
pass
|
||||
|
||||
return {
|
||||
"project_type": "claude-plugin",
|
||||
"version_files": [str(plugin_json)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return None
|
||||
|
||||
def _detect_generic(self) -> Optional[Dict[str, Any]]:
|
||||
"""Detect generic project with VERSION file."""
|
||||
version_file = self.root / "VERSION"
|
||||
|
||||
if version_file.exists():
|
||||
version = version_file.read_text().strip()
|
||||
return {
|
||||
"project_type": "generic",
|
||||
"version_files": [str(version_file)],
|
||||
"detected_version": version
|
||||
}
|
||||
|
||||
return {
|
||||
"project_type": "unknown",
|
||||
"version_files": [],
|
||||
"detected_version": None
|
||||
}
|
||||
|
||||
|
||||
def main():
|
||||
project_root = sys.argv[1] if len(sys.argv) > 1 else "."
|
||||
|
||||
detector = ProjectDetector(project_root)
|
||||
result = detector.detect()
|
||||
|
||||
print(json.dumps(result, indent=2))
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
154
skills/scripts/git_operations.py
Normal file
154
skills/scripts/git_operations.py
Normal file
@@ -0,0 +1,154 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Git operations wrapper with cross-platform support.
|
||||
Handles: commit, tag, push, branch detection
|
||||
"""
|
||||
|
||||
import subprocess
|
||||
import sys
|
||||
from pathlib import Path
|
||||
from typing import Optional, List
|
||||
|
||||
|
||||
class GitOperations:
|
||||
def __init__(self, repo_path: str = "."):
|
||||
self.repo_path = Path(repo_path).resolve()
|
||||
|
||||
def run_command(
|
||||
self,
|
||||
cmd: List[str],
|
||||
check: bool = True) -> subprocess.CompletedProcess[str]:
|
||||
"""Run git command with proper error handling."""
|
||||
try:
|
||||
result = subprocess.run(
|
||||
cmd,
|
||||
cwd=self.repo_path,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=check,
|
||||
encoding='utf-8'
|
||||
)
|
||||
return result
|
||||
except subprocess.CalledProcessError as e:
|
||||
print(f"Git command failed: {' '.join(cmd)}", file=sys.stderr)
|
||||
print(f"Error: {e.stderr}", file=sys.stderr)
|
||||
raise
|
||||
|
||||
def get_current_branch(self) -> str:
|
||||
"""Get current git branch name."""
|
||||
result = self.run_command(['git', 'branch', '--show-current'])
|
||||
return result.stdout.strip()
|
||||
|
||||
def get_status(self) -> str:
|
||||
"""Get git status."""
|
||||
result = self.run_command(['git', 'status', '--porcelain'])
|
||||
return result.stdout
|
||||
|
||||
def add_files(self, files: Optional[List[str]] = None) -> bool:
|
||||
"""Stage files for commit."""
|
||||
if files:
|
||||
self.run_command(['git', 'add'] + files)
|
||||
else:
|
||||
self.run_command(['git', 'add', '-A'])
|
||||
|
||||
print("✓ Files staged for commit")
|
||||
return True
|
||||
|
||||
def commit(self, message: str) -> bool:
|
||||
"""Create git commit."""
|
||||
self.run_command(['git', 'commit', '-m', message])
|
||||
print(f"✓ Committed: {message.split('\n')[0][:60]}...")
|
||||
return True
|
||||
|
||||
def create_tag(self, tag_name: str, message: Optional[str] = None) -> bool:
|
||||
"""Create annotated git tag."""
|
||||
cmd = ['git', 'tag', '-a', tag_name]
|
||||
|
||||
if message:
|
||||
cmd.extend(['-m', message])
|
||||
else:
|
||||
cmd.extend(['-m', f"Release {tag_name}"])
|
||||
|
||||
self.run_command(cmd)
|
||||
print(f"✓ Created tag: {tag_name}")
|
||||
return True
|
||||
|
||||
def push(
|
||||
self,
|
||||
remote: str = 'origin',
|
||||
branch: Optional[str] = None,
|
||||
tags: bool = False) -> bool:
|
||||
"""Push commits and/or tags to remote."""
|
||||
if tags:
|
||||
# Push tags
|
||||
cmd = ['git', 'push', remote, '--tags']
|
||||
self.run_command(cmd)
|
||||
print(f"✓ Pushed tags to {remote}")
|
||||
else:
|
||||
# Push branch
|
||||
if not branch:
|
||||
branch = self.get_current_branch()
|
||||
|
||||
cmd = ['git', 'push', remote, branch]
|
||||
self.run_command(cmd)
|
||||
print(f"✓ Pushed {branch} to {remote}")
|
||||
|
||||
return True
|
||||
|
||||
def tag_exists(self, tag_name: str) -> bool:
|
||||
"""Check if tag exists."""
|
||||
result = self.run_command(['git', 'tag', '-l', tag_name], check=False)
|
||||
return bool(result.stdout.strip())
|
||||
|
||||
|
||||
def main():
|
||||
if len(sys.argv) < 2:
|
||||
print("Usage:", file=sys.stderr)
|
||||
print(" python git_operations.py commit <message>", file=sys.stderr)
|
||||
print(
|
||||
" python git_operations.py tag <tag_name> [message]",
|
||||
file=sys.stderr)
|
||||
print(" python git_operations.py push [branch]", file=sys.stderr)
|
||||
print(" python git_operations.py push-tags", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
action = sys.argv[1]
|
||||
git = GitOperations()
|
||||
|
||||
try:
|
||||
if action == 'commit':
|
||||
if len(sys.argv) < 3:
|
||||
print("Error: Commit message required", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
message = sys.argv[2]
|
||||
git.add_files()
|
||||
git.commit(message)
|
||||
|
||||
elif action == 'tag':
|
||||
if len(sys.argv) < 3:
|
||||
print("Error: Tag name required", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
tag_name = sys.argv[2]
|
||||
message = sys.argv[3] if len(sys.argv) > 3 else None
|
||||
git.create_tag(tag_name, message)
|
||||
|
||||
elif action == 'push':
|
||||
branch = sys.argv[2] if len(sys.argv) > 2 else None
|
||||
git.push(branch=branch)
|
||||
|
||||
elif action == 'push-tags':
|
||||
git.push(tags=True)
|
||||
|
||||
else:
|
||||
print(f"Error: Unknown action '{action}'", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error: {e}", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
87
skills/scripts/sync_unity_version.py
Normal file
87
skills/scripts/sync_unity_version.py
Normal file
@@ -0,0 +1,87 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Sync Unity version from version.json to ProjectSettings.asset.
|
||||
This ensures version.json is the single source of truth.
|
||||
"""
|
||||
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
def sync_unity_version(project_root: str = ".") -> bool:
|
||||
"""Sync version from version.json to ProjectSettings.asset."""
|
||||
root = Path(project_root).resolve()
|
||||
|
||||
version_json_path = root / "version.json"
|
||||
project_settings_path = root / "ProjectSettings" / "ProjectSettings.asset"
|
||||
|
||||
# Check if files exist
|
||||
if not version_json_path.exists():
|
||||
print(
|
||||
f"Error: version.json not found at {version_json_path}",
|
||||
file=sys.stderr)
|
||||
return False
|
||||
|
||||
if not project_settings_path.exists():
|
||||
print(
|
||||
f"Error: ProjectSettings.asset not found at "
|
||||
f"{project_settings_path}",
|
||||
file=sys.stderr)
|
||||
return False
|
||||
|
||||
try:
|
||||
# Read version from version.json
|
||||
version_data = json.loads(
|
||||
version_json_path.read_text(
|
||||
encoding='utf-8'))
|
||||
version = version_data.get('version')
|
||||
|
||||
if not version:
|
||||
print(
|
||||
"Error: 'version' field not found in version.json",
|
||||
file=sys.stderr)
|
||||
return False
|
||||
|
||||
# Read ProjectSettings.asset
|
||||
content = project_settings_path.read_text(encoding='utf-8')
|
||||
|
||||
# Find and replace bundleVersion
|
||||
pattern = r'(bundleVersion:\s*)(.+)'
|
||||
replacement = r'\g<1>' + version
|
||||
|
||||
if not re.search(pattern, content):
|
||||
print(
|
||||
"Error: bundleVersion not found in ProjectSettings.asset",
|
||||
file=sys.stderr)
|
||||
return False
|
||||
|
||||
# Update content
|
||||
new_content = re.sub(pattern, replacement, content)
|
||||
|
||||
if new_content == content:
|
||||
print(f"✓ Version already synced: {version}")
|
||||
return True
|
||||
|
||||
# Write back
|
||||
project_settings_path.write_text(new_content, encoding='utf-8')
|
||||
print(f"✓ Synced Unity version: {version}")
|
||||
print(" version.json → ProjectSettings.asset")
|
||||
|
||||
return True
|
||||
|
||||
except (json.JSONDecodeError, IOError, UnicodeDecodeError) as e:
|
||||
print(f"Error syncing Unity version: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
|
||||
def main():
|
||||
project_root = sys.argv[1] if len(sys.argv) > 1 else "."
|
||||
|
||||
if not sync_unity_version(project_root):
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
231
skills/scripts/update_version.py
Normal file
231
skills/scripts/update_version.py
Normal file
@@ -0,0 +1,231 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Universal version updater supporting multiple file formats.
|
||||
Supports: JSON, TOML, YAML, plain text, Unity asset files, etc.
|
||||
"""
|
||||
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
from typing import List
|
||||
|
||||
|
||||
class VersionUpdater:
|
||||
def __init__(self):
|
||||
self.updated_files: List[str] = []
|
||||
|
||||
def update(self, file_path: str, new_version: str) -> bool:
|
||||
"""Update version in file based on its format."""
|
||||
path = Path(file_path)
|
||||
|
||||
if not path.exists():
|
||||
print(f"Error: File not found: {file_path}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
# Detect file type and update accordingly
|
||||
if path.suffix == '.json':
|
||||
return self._update_json(path, new_version)
|
||||
elif path.suffix == '.toml':
|
||||
return self._update_toml(path, new_version)
|
||||
elif path.suffix in ['.yaml', '.yml']:
|
||||
return self._update_yaml(path, new_version)
|
||||
elif path.name == 'ProjectSettings.asset':
|
||||
return self._update_unity_asset(path, new_version)
|
||||
elif path.suffix == '.uproject':
|
||||
return self._update_unreal_uproject(path, new_version)
|
||||
elif path.name in ['VERSION', 'version.txt']:
|
||||
return self._update_plain_text(path, new_version)
|
||||
else:
|
||||
print(f"Warning: Unknown file type: {file_path}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_json(self, path: Path, new_version: str) -> bool:
|
||||
"""Update version in JSON file."""
|
||||
try:
|
||||
data = json.loads(path.read_text(encoding='utf-8'))
|
||||
|
||||
# Update version field
|
||||
if 'version' in data:
|
||||
old_version = data['version']
|
||||
data['version'] = new_version
|
||||
print(f"Updated {path.name}: {old_version} → {new_version}")
|
||||
else:
|
||||
data['version'] = new_version
|
||||
print(f"Added version to {path.name}: {new_version}")
|
||||
|
||||
# Write back with proper formatting
|
||||
path.write_text(
|
||||
json.dumps(
|
||||
data,
|
||||
indent=2,
|
||||
ensure_ascii=False) +
|
||||
'\n',
|
||||
encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_toml(self, path: Path, new_version: str) -> bool:
|
||||
"""Update version in TOML file."""
|
||||
try:
|
||||
content = path.read_text(encoding='utf-8')
|
||||
|
||||
# Try to find and replace version
|
||||
patterns = [
|
||||
(r'(version\s*=\s*["\'])([^"\']+)(["\'])',
|
||||
r'\g<1>' + new_version + r'\g<3>'),
|
||||
(r'(\[project\].*?version\s*=\s*["\'])([^"\']+)(["\'])',
|
||||
r'\g<1>' + new_version + r'\g<3>'),
|
||||
]
|
||||
|
||||
updated = False
|
||||
for pattern, replacement in patterns:
|
||||
if re.search(pattern, content, re.DOTALL):
|
||||
content = re.sub(
|
||||
pattern, replacement, content, flags=re.DOTALL)
|
||||
updated = True
|
||||
break
|
||||
|
||||
if updated:
|
||||
path.write_text(content, encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
print(f"Updated {path.name} → {new_version}")
|
||||
return True
|
||||
else:
|
||||
print(
|
||||
f"Warning: Could not find version in {
|
||||
path.name}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_yaml(self, path: Path, new_version: str) -> bool:
|
||||
"""Update version in YAML file."""
|
||||
try:
|
||||
content = path.read_text(encoding='utf-8')
|
||||
|
||||
# Replace version field
|
||||
pattern = r'(version:\s*["\']?)([^"\'\n]+)(["\']?)'
|
||||
replacement = r'\g<1>' + new_version + r'\g<3>'
|
||||
|
||||
if re.search(pattern, content):
|
||||
content = re.sub(pattern, replacement, content)
|
||||
path.write_text(content, encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
print(f"Updated {path.name} → {new_version}")
|
||||
return True
|
||||
else:
|
||||
print(
|
||||
f"Warning: Could not find version in {
|
||||
path.name}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_unity_asset(self, path: Path, new_version: str) -> bool:
|
||||
"""Update bundleVersion in Unity ProjectSettings.asset."""
|
||||
try:
|
||||
content = path.read_text(encoding='utf-8')
|
||||
|
||||
# Replace bundleVersion
|
||||
pattern = r'(bundleVersion:\s*)(.+)'
|
||||
replacement = r'\g<1>' + new_version
|
||||
|
||||
if re.search(pattern, content):
|
||||
old_content = content
|
||||
content = re.sub(pattern, replacement, content)
|
||||
|
||||
if content != old_content:
|
||||
path.write_text(content, encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
print(
|
||||
f"Updated Unity ProjectSettings.asset → {new_version}")
|
||||
return True
|
||||
|
||||
print(
|
||||
f"Warning: Could not find bundleVersion in {
|
||||
path.name}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_unreal_uproject(self, path: Path, new_version: str) -> bool:
|
||||
"""Update version in Unreal .uproject file."""
|
||||
try:
|
||||
data = json.loads(path.read_text(encoding='utf-8'))
|
||||
|
||||
# Unreal uses EngineAssociation or custom Version field
|
||||
if 'Version' in data:
|
||||
old_version = data['Version']
|
||||
data['Version'] = new_version
|
||||
print(f"Updated {path.name}: {old_version} → {new_version}")
|
||||
else:
|
||||
data['Version'] = new_version
|
||||
print(f"Added Version to {path.name}: {new_version}")
|
||||
|
||||
path.write_text(
|
||||
json.dumps(
|
||||
data,
|
||||
indent=4,
|
||||
ensure_ascii=False) +
|
||||
'\n',
|
||||
encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
def _update_plain_text(self, path: Path, new_version: str) -> bool:
|
||||
"""Update plain text version file."""
|
||||
try:
|
||||
path.write_text(new_version + '\n', encoding='utf-8')
|
||||
self.updated_files.append(str(path))
|
||||
print(f"Updated {path.name} → {new_version}")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error updating {path}: {e}", file=sys.stderr)
|
||||
return False
|
||||
|
||||
|
||||
def main():
|
||||
if len(sys.argv) < 3:
|
||||
print(
|
||||
"Usage: python update_version.py <file_path> <new_version>",
|
||||
file=sys.stderr)
|
||||
print(
|
||||
" python update_version.py "
|
||||
"<file1> <file2> ... <new_version>",
|
||||
file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
files = sys.argv[1:-1]
|
||||
new_version = sys.argv[-1]
|
||||
|
||||
updater = VersionUpdater()
|
||||
success_count = 0
|
||||
|
||||
for file_path in files:
|
||||
if updater.update(file_path, new_version):
|
||||
success_count += 1
|
||||
|
||||
print(f"\nUpdated {success_count}/{len(files)} files successfully")
|
||||
|
||||
if success_count < len(files):
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user