Skip to content

Commit 1b83269

Browse files
JusterZhuclaude
andcommitted
feat: add root SKILL.md for SkillsMP and aggregation sites discovery
Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 99cec2d commit 1b83269

1 file changed

Lines changed: 165 additions & 0 deletions

File tree

SKILL.md

Lines changed: 165 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,165 @@
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

Comments
 (0)