|
| 1 | +--- |
| 2 | +name: generalupdate-skill-codegen |
| 3 | +description: | |
| 4 | + Complete Claude Code skill suite for integrating GeneralUpdate (.NET auto-update) into |
| 5 | + any .NET application. Generates dual-project scaffolding (Client+Upgrade), Bootstrap |
| 6 | + configuration (4 methods), full-state update UI (6 frameworks), 6 strategy implementations |
| 7 | + (Client-Server/OSS/Silent/Differential/CVP/Push), advanced extension points (IPC replacement, |
| 8 | + Bowl crash daemon, custom Hooks, AOT), and deep troubleshooting (50+ known issues). |
| 9 | + All templates target NuGet v10.4.6 stable API and pass dotnet build (0 errors). |
| 10 | +
|
| 11 | + Triggers on: "GeneralUpdate", "auto update", "自动更新", "update framework", |
| 12 | + ".NET update", "Claude Code skill suite", "GeneralUpdate Skill CodeGen", |
| 13 | + "generalupdate-init", "generalupdate-ui", "generalupdate-strategy", |
| 14 | + "generalupdate-advanced", "generalupdate-troubleshoot", |
| 15 | + "集成GeneralUpdate", "接入自动更新", "更新技能", "升级框架", |
| 16 | + ".NET自动更新", "双进程更新", "Bootstrap配置", |
| 17 | + "WPF update", "Avalonia update", "MAUI update", "WinForms update", |
| 18 | + "差分更新", "静默更新", "跨版本更新", "OSS更新", "推送更新", |
| 19 | + "Bowl崩溃守护", "IPC通讯", "NamedPipe", "更新UI界面", |
| 20 | + "update troubleshooting", "更新失败排查", "升级报错". |
| 21 | + Also triggers on common .NET + update combinations. |
| 22 | +
|
| 23 | + Contains 5 sub-skills: |
| 24 | + - generalupdate-init: Dual-project scaffolding + Bootstrap config |
| 25 | + - generalupdate-ui: Full-state update UI for 6 frameworks |
| 26 | + - generalupdate-strategy: 6 strategy decision tree + examples |
| 27 | + - generalupdate-advanced: 10+ extension points + Bowl + IPC + AOT |
| 28 | + - generalupdate-troubleshoot: 50+ known issues diagnosis |
| 29 | +when_to_use: | |
| 30 | + - First-time integration of GeneralUpdate into any .NET project |
| 31 | + - User needs auto-update capability for WPF/WinForms/Avalonia/MAUI/console app |
| 32 | + - User wants production-ready update code with proper error handling |
| 33 | + - User needs to choose the right update strategy for their deployment scenario |
| 34 | + - User reports update failures and needs deep troubleshooting |
| 35 | + - User wants advanced customization: custom IPC, Bowl daemon, AOT compatibility |
| 36 | + - General Claude Code entry point for anything .NET update related |
| 37 | +allowed-tools: "Bash, Read, Write, Edit, Glob, Grep, WebSearch" |
| 38 | +--- |
| 39 | + |
| 40 | +# 🚀 GeneralUpdate Skill CodeGen |
| 41 | + |
| 42 | +**Claude Code 技能套件** — 帮助 .NET 开发者在 5 分钟内将 [GeneralUpdate](https://github.com/GeneralLibrary/GeneralUpdate) 自动更新系统集成到任意 .NET 应用中。 |
| 43 | + |
| 44 | +覆盖 50+ 真实 Issue 发现的已知问题,提供即用型代码生成 + 深度故障排查。 |
| 45 | + |
| 46 | +> **Current Version: 0.0.1-bate.1** — targets NuGet `GeneralUpdate.Core ≥ 10.4.6` stable release |
| 47 | +> 兼容性:`v10.4.6`(NuGet 最新稳定版) |
| 48 | +> 所有 32 个模板文件已通过 `dotnet build` 编译验证(0 errors)。 |
| 49 | +
|
| 50 | +## Skills Overview |
| 51 | + |
| 52 | +| Skill | Command | Description | Coverage | |
| 53 | +|-------|---------|-------------|----------| |
| 54 | +| 🚀 `generalupdate-init` | `/generalupdate-init` | 双项目脚手架 + Bootstrap 配置(4 种方式) | 4 大场景 + 4 种配置方式 + 完整 API | |
| 55 | +| 🎨 `generalupdate-ui` | `/generalupdate-ui` | 自动识别 UI 框架,生成全状态更新窗口(11 种状态) | 6 UI 框架 + 全状态机 + 桥接代码 | |
| 56 | +| ⚙️ `generalupdate-strategy` | `/generalupdate-strategy` | 6 种策略决策树 + 混合组合 + 平台差异 | 6 策略 + 4 组合 + 平台对照 | |
| 57 | +| 🔧 `generalupdate-advanced` | `/generalupdate-advanced` | 10+ 扩展点 + 4 种 IPC + Bowl + AOT | 10+ 扩展点 + 完整架构图 | |
| 58 | +| 🩺 `generalupdate-troubleshoot` | `/generalupdate-troubleshoot` | 50+ 已知问题诊断 + 6 步通用排查 | 8 致命 + 11 高 + 20 中 + 12 低 | |
| 59 | + |
| 60 | +## Quick Start |
| 61 | + |
| 62 | +在 Claude Code 中,只需描述你的需求: |
| 63 | + |
| 64 | +``` |
| 65 | +"给我的 WPF 应用添加自动更新" |
| 66 | +→ 自动激活 generalupdate-init + generalupdate-ui |
| 67 | +
|
| 68 | +"更新成功了但启动报错" |
| 69 | +→ 自动激活 generalupdate-troubleshoot |
| 70 | +
|
| 71 | +"配置 OSS 静默更新" |
| 72 | +→ 自动激活 generalupdate-strategy |
| 73 | +
|
| 74 | +"添加 Bowl 崩溃守护 + 自定义 Hooks" |
| 75 | +→ 自动激活 generalupdate-advanced |
| 76 | +``` |
| 77 | + |
| 78 | +### Prerequisites |
| 79 | + |
| 80 | +1. **Claude Code**: 需要安装并配置 [Claude Code CLI](https://claude.com/claude-code) |
| 81 | +2. **.NET SDK**: 目标项目需基于 .NET 8+(推荐 .NET 10) |
| 82 | +3. **GeneralUpdate 服务端**: 对于标准策略,需要部署 [GeneralSpacestation](https://github.com/JusterZhu/GeneralSpacestation) 或兼容的后端服务 |
| 83 | +4. **双进程架构**: 需要理解 Client + Upgrade 双进程的核心理念 |
| 84 | + |
| 85 | +## Data Sources |
| 86 | + |
| 87 | +所有技能的内容基于以下真实数据: |
| 88 | + |
| 89 | +- **GitHub Issues**: #308–#517(重构、Bug、功能、测试) |
| 90 | +- **Gitee Issues**: 30 个真实用户反馈(中文社区痛点) |
| 91 | +- **全面代码审计**: 17 CRITICAL/HIGH + 14 MEDIUM + 10 INFO 发现 |
| 92 | +- **Samples 源码**: CompleteUpdateSample、SilentUpdateSample、OssSample、DifferentialSample、PushSample、BowlSample、ExtensionSample、CompressSample、ImDiskQuickInstallSample |
| 93 | +- **UI Samples**: SemiUrsa、LayUI、AntdUI、WPFDevelopers、MauiUpdate、AndroidUpdate |
| 94 | + |
| 95 | +## Skill File Structure |
| 96 | + |
| 97 | +``` |
| 98 | +.claude/skills/ |
| 99 | +├── generalupdate-init/ (7 files) |
| 100 | +│ ├── SKILL.md ← 4 大场景 + 4 种配置 + API 详解 |
| 101 | +│ ├── reference.md ← NuGet/API/协议/框架兼容性 |
| 102 | +│ └── templates/ |
| 103 | +│ ├── MinimalIntegration.cs |
| 104 | +│ ├── FullIntegration.cs |
| 105 | +│ ├── generalupdate.manifest.json |
| 106 | +│ └── project-scaffold/ |
| 107 | +│ |
| 108 | +├── generalupdate-ui/ (10 files) |
| 109 | +│ ├── SKILL.md ← 11 状态 UI 状态机 + 框架检测逻辑 |
| 110 | +│ └── templates/ |
| 111 | +│ ├── RealDownloadService.cs |
| 112 | +│ ├── DownloadViewModels.cs |
| 113 | +│ ├── SemiUrsaClientView.axaml / SemiUrsaUpgradeView.axaml |
| 114 | +│ ├── LayUIStyle.xaml / WPFDevelopersStyle.xaml |
| 115 | +│ ├── AntdUIStyle.cs |
| 116 | +│ └── MauiUpdatePage.xaml/.cs |
| 117 | +│ |
| 118 | +├── generalupdate-strategy/ (7 files) |
| 119 | +│ ├── SKILL.md ← 决策树 + 6 策略详解 + 混合 + 平台对照 |
| 120 | +│ └── examples/ |
| 121 | +│ ├── ClientServerStrategy.cs / OssStrategy.cs |
| 122 | +│ ├── SilentStrategy.cs / DifferentialStrategy.cs |
| 123 | +│ └── CrossVersionStrategy.cs / PushStrategy.cs |
| 124 | +│ |
| 125 | +├── generalupdate-advanced/ (6 files) |
| 126 | +│ ├── SKILL.md ← 10+ 扩展点 + 4 IPC + Bowl + 事件系统 |
| 127 | +│ ├── reference.md |
| 128 | +│ └── templates/ |
| 129 | +│ ├── CustomHooks.cs / CustomStrategy.cs |
| 130 | +│ ├── BowlIntegration.cs / NamedPipeIPC.cs |
| 131 | +│ |
| 132 | +└── generalupdate-troubleshoot/ (2 files) |
| 133 | + ├── SKILL.md ← 诊断工作流 |
| 134 | + └── reference.md ← 50+ 症状清单(C/H/M/L 四级) |
| 135 | +``` |
| 136 | + |
| 137 | +## API Compatibility |
| 138 | + |
| 139 | +> ⚠️ **NuGet Reference Rules**: |
| 140 | +> - Core only: `dotnet add package GeneralUpdate.Core` |
| 141 | +> - With Bowl: reference **only** `GeneralUpdate.Bowl`(传递依赖 Core,两者不能共存) |
| 142 | +> - Differential 已嵌入 Core,**无需**额外引用 `GeneralUpdate.Differential` |
| 143 | +
|
| 144 | +> ⚠️ **API Surface**: v10.4.6 稳定版 API 与开发分支(v10.5.0-beta.2)有根本性差异。当前稳定版不支持: |
| 145 | +> - ❌ 无可编程 `Option` 配置系统(仅 `Configinfo` 属性) |
| 146 | +> - ❌ 无 `IUpdateHooks` 生命周期钩子 |
| 147 | +> - ❌ 无 `IStrategy` 可替换策略接口 |
| 148 | +> - ❌ 无 `SilentPollOrchestrator` |
| 149 | +> - ❌ 无 `ProcessContract` / IPC 替换接口 |
| 150 | +
|
| 151 | +## Version History |
| 152 | + |
| 153 | +### 0.0.1-bate.1 — 2026-06-16 |
| 154 | + |
| 155 | +Initial beta release. All templates rewritten for NuGet v10.4.6 stable API. |
| 156 | + |
| 157 | +## License |
| 158 | + |
| 159 | +Apache 2.0 — 与 GeneralUpdate 主项目一致 |
| 160 | + |
| 161 | +## Related Projects |
| 162 | + |
| 163 | +- [GeneralUpdate](https://github.com/GeneralLibrary/GeneralUpdate) — .NET 自动更新核心库 |
| 164 | +- [GeneralSpacestation](https://github.com/JusterZhu/GeneralSpacestation) — 更新服务端 |
| 165 | +- [GeneralUpdate-Samples](https://github.com/GeneralLibrary/GeneralUpdate-Samples) — 示例项目合集 |
0 commit comments