# generalupdate-skill-codegen **Repository Path**: GeneralLibrary/generalupdate-skill-codegen ## Basic Information - **Project Name**: generalupdate-skill-codegen - **Description**: Claude Code skill suite β€” auto-generate GeneralUpdate auto-update integration code for any .NET app in under 5 minutes. Covers scaffold, UI, strategy, advanced, and troubleshooting. - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-06-16 - **Last Updated**: 2026-06-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # GeneralUpdate Skill CodeGen **Claude Code Skill Suite** β€” helps .NET developers integrate the [GeneralUpdate](https://github.com/GeneralLibrary/GeneralUpdate) auto-update system into any .NET application in under 5 minutes. Covers 50+ known issues discovered from real GitHub/Gitee feedback, providing production-ready code generation and deep troubleshooting. > Version: 0.0.1-bate.1 (2026-06-16) --- ## Skills Overview | Skill | Command | One-Liner | Coverage | |-------|---------|-----------|----------| | πŸš€ `generalupdate-init` | `/generalupdate-init` | Dual-project scaffold + Bootstrap config (4 methods) | 4 scenes + 4 config methods + full API | | 🎨 `generalupdate-ui` | `/generalupdate-ui` | Auto-detect UI framework, generate full-state update window (11 states) | 6 UI frameworks + full state machine + bridge code | | βš™οΈ `generalupdate-strategy` | `/generalupdate-strategy` | 6-strategy decision tree + mixed combinations + platform diff | 6 strategies + 4 combos + platform matrix | | πŸ”§ `generalupdate-advanced` | `/generalupdate-advanced` | 10+ extension points + 4 IPC + Bowl + AOT | 10+ ext points + full architecture diagram | | 🩺 `generalupdate-troubleshoot` | `/generalupdate-troubleshoot` | 50+ known issues diagnosis + 6-step universal check | 8 critical + 11 high + 20 medium + 12 low | --- ## Quick Start In Claude Code, simply describe your needs: ``` "Add auto-update to my WPF app" β†’ Automatically activates generalupdate-init + generalupdate-ui "Update succeeded but the app crashes on startup" β†’ Automatically activates generalupdate-troubleshoot "Configure OSS silent update" β†’ Automatically activates generalupdate-strategy "Add Bowl crash daemon + custom Hooks" β†’ Automatically activates generalupdate-advanced ``` ### Prerequisites 1. **Claude Code**: requires [Claude Code CLI](https://claude.com/claude-code) installed and configured 2. **.NET SDK**: target project must target .NET 8+ (.NET 10 recommended) 3. **GeneralUpdate Server**: for standard strategies, deploy [GeneralSpacestation](https://github.com/JusterZhu/GeneralSpacestation) or a compatible backend 4. **Dual-Process Architecture**: basic understanding of the Client + Upgrade dual-process model --- ## Data Sources All skill content is derived from real-world sources: - **GitHub Issues**: #308–#517 (refactoring, bugs, features, tests) - **Gitee Issues**: 30 real user reports (Chinese community pain points) - **Full Code Audit**: 17 CRITICAL/HIGH + 14 MEDIUM + 10 INFO findings - **Samples Source**: CompleteUpdateSample, SilentUpdateSample, OssSample, DifferentialSample, PushSample, BowlSample, ExtensionSample, CompressSample, ImDiskQuickInstallSample - **UI Samples**: SemiUrsa, LayUI, AntdUI, WPFDevelopers, MauiUpdate, AndroidUpdate --- ## Skill File Structure ``` .claude/skills/ β”œβ”€β”€ generalupdate-init/ (7 files) β”‚ β”œβ”€β”€ SKILL.md ← 4 scenes + 3 config methods + API deep-dive β”‚ β”œβ”€β”€ reference.md ← NuGet/API/protocol/framework compatibility β”‚ └── templates/ β”‚ β”œβ”€β”€ MinimalIntegration.cs ← 3 lines + annotations β”‚ β”œβ”€β”€ FullIntegration.cs ← Full config + Upgrade process + appsettings β”‚ β”œβ”€β”€ generalupdate.manifest.json β”‚ └── project-scaffold/ β”‚ β”œβ”€β”€ ClientApp.csproj / ClientProgram.cs β”‚ └── UpgradeApp.csproj / UpgradeProgram.cs β”‚ β”œβ”€β”€ generalupdate-ui/ (10 files) β”‚ β”œβ”€β”€ SKILL.md ← 11-state UI state machine + framework detection β”‚ └── templates/ β”‚ β”œβ”€β”€ RealDownloadService.cs ← β˜… Core bridge: Mockβ†’GeneralUpdate β”‚ β”œβ”€β”€ DownloadViewModels.cs ← Full-state MVVM ViewModel β”‚ β”œβ”€β”€ SemiUrsaClientView.axaml ← Avalonia full-state window β”‚ β”œβ”€β”€ SemiUrsaUpgradeView.axaml β”‚ β”œβ”€β”€ LayUIStyle.xaml ← WPF+LayUI β”‚ β”œβ”€β”€ WPFDevelopersStyle.xaml ← WPF+WPFDevelopers β”‚ β”œβ”€β”€ AntdUIStyle.cs ← WinForms+AntdUI β”‚ └── MauiUpdatePage.xaml/.cs ← MAUI β”‚ β”œβ”€β”€ generalupdate-strategy/ (7 files) β”‚ β”œβ”€β”€ SKILL.md ← Decision tree + 6 strategies + mixing + platform β”‚ └── examples/ β”‚ β”œβ”€β”€ ClientServerStrategy.cs ← Standard server mode β”‚ β”œβ”€β”€ OssStrategy.cs ← Object storage mode β”‚ β”œβ”€β”€ SilentStrategy.cs ← Silent polling mode β”‚ β”œβ”€β”€ DifferentialStrategy.cs ← Delta update mode β”‚ β”œβ”€β”€ CrossVersionStrategy.cs ← Cross-version CVP mode β”‚ └── PushStrategy.cs ← SignalR push mode β”‚ β”œβ”€β”€ generalupdate-advanced/ (6 files) β”‚ β”œβ”€β”€ SKILL.md ← 10+ ext points + 4 IPC + Bowl + event system β”‚ β”œβ”€β”€ reference.md ← Extension API quick ref + Bowl options β”‚ └── templates/ β”‚ β”œβ”€β”€ CustomHooks.cs ← Full IUpdateHooks + Unix permissions β”‚ β”œβ”€β”€ CustomStrategy.cs ← Custom platform strategy β”‚ β”œβ”€β”€ BowlIntegration.cs ← Crash daemon config β”‚ └── NamedPipeIPC.cs ← Named pipe IPC replacement β”‚ └── generalupdate-troubleshoot/ (2 files) β”œβ”€β”€ SKILL.md ← Diagnostic workflow └── reference.md ← β˜… 50+ symptom catalog (C/H/M/L levels) ``` --- ## Known Limitations > ⚠️ **NuGet Reference Rules**: > - Core only: `dotnet add package GeneralUpdate.Core` > - With Bowl: reference **only** `GeneralUpdate.Bowl` (it transitively includes Core β€” the two cannot coexist) > - Differential types are already embedded in Core, **no need** for `GeneralUpdate.Differential` > ⚠️ **API Surface**: The NuGet stable release (v10.4.6) has a simpler API than the development branch (v10.5.0-beta.2). The following are **not available** in the current stable release: > - No programmable `Option` config system (only `Configinfo` properties) > - No `IUpdateHooks` lifecycle hooks > - No `IStrategy` replaceable strategy interface > - No `SilentPollOrchestrator` > - No `ProcessContract`/IPC replacement interface > > These features may ship in a future version. All templates target the **stable v10.4.6** API. See [BUGS.md](BUGS.md) for the full audit trail. --- ## Contributing 1. File an Issue to report bugs or request features 2. Fork this repo, add/modify skills under `.claude/skills/` 3. Ensure template code aligns with the latest GeneralUpdate API 4. Submit a PR ### Development Guide ```bash # Test skills locally in Claude Code claude-code --load-skills .claude/skills/ # Verify template code compiles dotnet build your-test-project/ ``` --- ## License Apache 2.0 β€” consistent with the GeneralUpdate main project. ## Related Projects - [GeneralUpdate](https://github.com/GeneralLibrary/GeneralUpdate) β€” .NET auto-update core library - [GeneralSpacestation](https://github.com/JusterZhu/GeneralSpacestation) β€” Update server backend - [GeneralUpdate-Samples](https://github.com/GeneralLibrary/GeneralUpdate-Samples) β€” Sample projects collection