跳到主要内容

🚀 GeneralUpdate Agent Skills 套件

Claude Code 技能套件 — 帮助 .NET 开发者在 5 分钟内将 GeneralUpdate 自动更新系统集成到任意 .NET 应用中。

覆盖 50+ 真实 Issue 发现的已知问题，提供即用型代码生成 + 深度故障排查。

Current Version: 0.0.2-beta.1 — targets NuGet GeneralUpdate.Core 10.5.0-rc.1
兼容性：v10.5.0-rc.1（NuGet 最新预览版）
所有模板已通过 dotnet build 编译验证（0 errors）。

📖 什么是 Agent Skill？​

Agent Skill（智能体技能）是一种可复用指令模板，让 AI 编程助手获得特定领域的专业知识和工作流程。

用一句话概括：Skill = 领域专家知识 + 标准化工作流，注入到 AI 助手中，让它能像资深开发者一样处理该领域的问题。

Skill 解决了什么问题？​

在没有 Skill 的情况下，让 AI 助手帮你做 GeneralUpdate 集成，你需要：

  1. 详细解释 GeneralUpdate 的双进程架构、API、策略……AI 才能理解上下文
  2. 每次对话都要重复这些背景知识
  3. AI 生成的代码可能遗漏边界情况、安全注意事项

有了 Skill 之后：

  1. 一条命令（如 /generalupdate-init）就能触发完整的工作流
  2. AI 自动加载领域知识（架构、API、已知问题、最佳实践）
  3. 输出标准化、经实战验证的代码

本套件包含 7 个 Skill​

Skill作用一句话
generalupdate-init从零搭建双项目脚手架 + Bootstrap 配置
generalupdate-ui自动识别 UI 框架，生成全状态更新窗口
generalupdate-strategy按场景选择最优更新策略（OSS/静默/差分等）
generalupdate-advancedBowl 崩溃守护、IPC、Pipeline、自定义 Hook
generalupdate-troubleshoot诊断 50+ 已知问题，匹配修复方案
generalupdate-migrationv9.x → v10 / dev-branch → stable 迁移
generalupdate-security-audit14 项安全检查 + 修复建议

📦 安装 Skills​

获取 Skill 文件​

所有 Skill 文件托管在独立仓库：

https://github.com/GeneralLibrary/generalupdate-skill-codegen

仓库包含：

generalupdate-skill-codegen/
├── SKILL.md                          ← 套件入口
└── .claude/skills/
    ├── generalupdate-init/           ← 🚀 集成指南
    ├── generalupdate-ui/             ← 🎨 界面生成
    ├── generalupdate-strategy/       ← ⚙️ 策略指南
    ├── generalupdate-advanced/       ← 🔧 高级定制
    ├── generalupdate-troubleshoot/   ← 🩺 故障排查
    ├── generalupdate-migration/      ← 🔄 迁移指南
    └── generalupdate-security-audit/ ← 🔒 安全审计

方式一：直接克隆到项目​

# 在你的项目根目录下执行
git clone https://github.com/GeneralLibrary/generalupdate-skill-codegen.git
cp -r generalupdate-skill-codegen/.claude/skills .claude/
cp generalupdate-skill-codegen/SKILL.md .claude/
rm -rf generalupdate-skill-codegen

方式二：作为 git submodule 管理（推荐团队协作）​

# 在你的项目根目录下执行
git submodule add https://github.com/GeneralLibrary/generalupdate-skill-codegen.git .claude/generalupdate-skill-codegen
ln -s .claude/generalupdate-skill-codegen/.claude/skills .claude/skills 2>/dev/null || \
  cp -r .claude/generalupdate-skill-codegen/.claude/skills .claude/

submodule 方式的好处：通过 git submodule update --remote 即可获取 Skill 的最新更新。

方式三：仅复制需要的 Skill​

# 只复制你需要的 skill
git clone https://github.com/GeneralLibrary/generalupdate-skill-codegen.git /tmp/gussc
cp -r /tmp/gussc/.claude/skills/generalupdate-init .claude/skills/
rm -rf /tmp/gussc

🤖 集成到各种 AI 编程助手​

本套件支持以下 AI 编程助手。根据你使用的工具选择对应的集成方式：

Claude Code（桌面版 / CLI）​

桌面版：

  1. 在项目根目录放置 .claude/skills/ 目录（参考上面的安装步骤）
  2. 重启 Claude Code 桌面版
  3. 输入 /generalupdate-init 即可使用

CLI 版：

  1. 在项目根目录放置 .claude/skills/ 目录
  2. 重新启动 Claude Code CLI
  3. 输入 /generalupdate-init 测试

验证方式：输入 /generalupdate-init，看到集成指南输出即为成功。

GitHub Copilot（VS Code）​

安装到 .github/copilot-instructions.md（或项目 instructions）：

  1. 将 generalupdate-skill-codegen/SKILL.md 的内容整理为 instructions
  2. 放置在项目根目录的 .github/copilot-instructions.md
  3. 或在 GitHub 仓库设置中添加为 Copilot 知识库

注意：GitHub Copilot 使用 instructions 机制而非 slash 命令，因此需要将 Skill 内容转换为 instructions 格式。

Cursor​

Cursor 支持 .cursorrules 文件，类似 Claude Code 的 skills：

  1. 在项目根目录创建或编辑 .cursorrules
  2. 将需要的 Skill 内容（如 generalupdate-init/SKILL.md）的核心指令追加到 .cursorrules
  3. 或使用 Cursor 的 Docs 功能，将 skill-codegen 仓库添加为参考文档

Windsurf​

  1. 在项目根目录创建 .windsurfrules 文件
  2. 将需要的 Skill 知识嵌入该文件
  3. 引用方式：在对话中直接描述需求，AI 会基于规则文件中的知识回答

Cline / Continue.dev（VS Code 插件）​

  1. 在 .clinerules 或 .cursorrules / .continuerc 中引用 Skill 知识
  2. 或直接将 Skill 内容添加到项目的 AI 规则文件中

DeepSeek / 通义灵码 等国内 AI 助手​

  • 在项目根目录建议放置一个 AI_INSTRUCTIONS.md 或 CODEGEN.md
  • 将关键 Skill 指令以自然语言描述写入该文件
  • 在对话开始时引用该文件作为上下文

✅ 验证安装​

无论在哪个 AI 助手中使用，验证方式都是：

尝试让 AI 帮你 "给我的 .NET 应用添加自动更新"

如果 AI 输出了 GeneralUpdate 双项目结构 + Bootstrap 配置代码 → 安装成功
如果 AI 只给出了通用建议 → 需要补充 Skill 上下文

先决条件​

  1. AI 编程助手: 需要一个支持自定义指令/规则的 AI 编程工具
  2. .NET SDK: 目标项目需基于 .NET 8+（推荐 .NET 10）
  3. GeneralUpdate 服务端: 对于标准策略，需要部署 GeneralSpacestation 或兼容的后端服务
  4. 双进程架构: 需要理解 Client + Upgrade 双进程的核心理念

🧭 开发者集成路线图​

你是哪种情况？找到你的入口，按步骤推进：

你的场景从哪开始做什么完成后下一步
🆕 第一次加更新，从零开始/generalupdate-init① 选集成模式 → ② 生成 Bootstrap → ③ 部署/generalupdate-ui（加界面）
🎨 已有集成，需要更新界面/generalupdate-ui① 自动检测框架 → ② 生成窗口 → ③ 桥接事件/generalupdate-strategy（选策略）
⚙️ 要选更新策略（OSS/静默/差分）/generalupdate-strategy① 决策树选策略 → ② 配置服务端 → ③ 示例代码/generalupdate-init（配置 Bootstrap）
🔧 需要高级定制（Bowl/IPC/Hooks）/generalupdate-advanced① 选扩展点 → ② 生成模板代码 → ③ 集成部署验证
🩺 更新失败/报错/异常/generalupdate-troubleshoot① 症状收集 → ② 匹配已知问题 → ③ 修复回到对应 skill 改配置
🔄 已有 v9.x 要迁移到 v10/generalupdate-migration参考迁移路径 + API 对照表/generalupdate-troubleshoot（检查迁移问题）
🔒 需要安全审计/generalupdate-security-audit14 项安全检查 + 审计报告/generalupdate-init（修复发现的问题）

Skills 总览​

Skill命令描述覆盖范围
🚀 generalupdate-init/generalupdate-init双项目脚手架 + Bootstrap 配置（4 种方式）4 大场景 + 4 种配置方式 + 完整 API
🎨 generalupdate-ui/generalupdate-ui自动识别 UI 框架，生成全状态更新窗口（11 种状态）6 UI 框架 + 全状态机 + 桥接代码
⚙️ generalupdate-strategy/generalupdate-strategy6 种策略决策树 + 混合组合 + 平台差异6 策略 + 4 组合 + 平台对照
🔧 generalupdate-advanced/generalupdate-advanced10+ 扩展点 + 4 种 IPC + Bowl + AOT10+ 扩展点 + 完整架构图
🩺 generalupdate-troubleshoot/generalupdate-troubleshoot50+ 已知问题诊断 + BM25 搜索引擎8 致命 + 11 高 + 20 中 + 12 低
🔄 generalupdate-migration/generalupdate-migrationv9.x → v10 / dev-branch → stable 迁移2 条迁移路径 + API 对照表
🔒 generalupdate-security-audit/generalupdate-security-audit安全审计 + 修复建议14 项安全矩阵 + 审计报告模板

快速开始​

在 AI 编程助手中，只需描述你的需求，对应的 Skill 会自动激活：

"给我的 WPF 应用添加自动更新"
→ 自动激活 generalupdate-init + generalupdate-ui

"更新成功了但启动报错"
→ 自动激活 generalupdate-troubleshoot

"配置 OSS 静默更新"
→ 自动激活 generalupdate-strategy

"添加 Bowl 崩溃守护 + 自定义 Hooks"
→ 自动激活 generalupdate-advanced

"把 v9.x 的项目迁移到 v10"
→ 自动激活 generalupdate-migration

通用集成验证清单​

无论使用哪个 skill，完成集成后请逐项检查：

Bootstrap 配置​

  • UpdateRequest 的 6 个必填字段都已设置（UpdateUrl, AppSecretKey, MainAppName, ClientVersion, ProductId, InstallPath）
  • UpdateUrl 指向的服务端 API 可正常返回版本信息
  • AppSecretKey 长度 ≥ 16 字符，与服务端一致
  • InstallPath 指向正确的安装目录（生产环境用 AppDomain.CurrentDomain.BaseDirectory）
  • AppType 设置正确（Client = 1, Upgrade = 2）

NuGet & 编译​

  • Client 和 Upgrade 项目使用完全相同的 GeneralUpdate NuGet 版本
  • 项目能正常 dotnet build（0 errors）

部署结构​

  • UpgradeApp.exe 存在于发布目录（首个版本就必须有）
  • generalupdate.manifest.json 的 UpdateAppName 包含 .exe
  • IPC 文件（UpdateInfo.msg）路径在 Client/Upgrade 间一致
  • Encoding 设置为 Encoding.UTF8（防止 Linux/macOS 中文乱码）

数据来源​

所有技能的内容基于以下真实数据：

  • GitHub Issues: #308–#517（重构、Bug、功能、测试）
  • Gitee Issues: 30 个真实用户反馈（中文社区痛点）
  • 全面代码审计: 17 CRITICAL/HIGH + 14 MEDIUM + 10 INFO 发现
  • Samples 源码: CompleteUpdateSample、SilentUpdateSample、OssSample、DifferentialSample、PushSample、BowlSample、ExtensionSample、CompressSample、ImDiskQuickInstallSample
  • UI Samples: SemiUrsa、LayUI、AntdUI、WPFDevelopers、MauiUpdate、AndroidUpdate

Skill 文件结构​

.claude/skills/
├── generalupdate-init/         (7 files)
│   ├── SKILL.md                ← 4 大场景 + 4 种配置 + API 详解
│   ├── reference.md            ← NuGet/API/协议/框架兼容性
│   └── templates/
│       ├── MinimalIntegration.cs
│       ├── FullIntegration.cs
│       ├── generalupdate.manifest.json
│       └── project-scaffold/
│
├── generalupdate-ui/           (10 files)
│   ├── SKILL.md                ← 11 状态 UI 状态机 + 框架检测逻辑
│   └── templates/
│       ├── RealDownloadService.cs
│       ├── DownloadViewModels.cs
│       ├── SemiUrsaClientView.axaml / SemiUrsaUpgradeView.axaml
│       ├── LayUIStyle.xaml / WPFDevelopersStyle.xaml
│       ├── AntdUIStyle.cs
│       └── MauiUpdatePage.xaml/.cs
│
├── generalupdate-strategy/     (7 files)
│   ├── SKILL.md                ← 决策树 + 6 策略详解 + 混合 + 平台对照
│   └── examples/
│       ├── ClientServerStrategy.cs / OssStrategy.cs
│       ├── SilentStrategy.cs / DifferentialStrategy.cs
│       └── CrossVersionStrategy.cs / PushStrategy.cs
│
├── generalupdate-advanced/     (6 files)
│   ├── SKILL.md                ← 10+ 扩展点 + 4 IPC + Bowl + 事件系统
│   ├── reference.md
│   └── templates/
│       ├── CustomHooks.cs / CustomStrategy.cs
│       ├── BowlIntegration.cs / NamedPipeIPC.cs
│
├── generalupdate-troubleshoot/ (5+ files)
│   ├── SKILL.md                ← 诊断工作流
│   ├── reference.md            ← 50+ 症状清单（C/H/M/L 四级）
│   ├── scripts/search.py       ← BM25 搜索引擎
│   ├── scripts/core.py         ← BM25 算法核心
│   └── data/issues.csv         ← 51 条已知问题数据库
│
├── generalupdate-migration/    (1 file)
│   └── SKILL.md                ← v9.x→v10 / dev-branch→stable 迁移
│
└── generalupdate-security-audit/ (1 file)
    └── SKILL.md                ← 14 项安全审计矩阵

API 兼容性说明​

⚠️ NuGet 引用规则（v10.5.0-rc.1）:

  • Core only: dotnet add package GeneralUpdate.Core --version 10.5.0-rc.1
  • With Bowl: 同时引用 GeneralUpdate.Core 和 GeneralUpdate.Bowl（v10.5.0-rc.1 中无类型冲突）
  • Differential 已嵌入 Core，无需额外引用 GeneralUpdate.Differential

⚠️ API Surface: v10.5.0-rc.1 采用了全新的配置系统：

  • ✅ UpdateRequest / UpdateRequestBuilder — 替代旧的 Configinfo
  • ✅ SetSource(updateUrl, appSecretKey) — 零配置入口
  • ✅ SetOption<T>(Option<T>, T) — 可编程配置系统
  • ✅ IUpdateHooks — 生命周期钩子（Hooks<T>()）
  • ✅ IStrategy — 可替换策略接口（Strategy<T>()）
  • ✅ UseDiffPipeline(Action<DiffPipelineBuilder>) — 差分管道配置
  • ✅ SilentPollOrchestrator — 静默轮询
  • ✅ AddListenerProgress — 第 7 个事件监听器
  • ❌ Configinfo 类已被移除

反馈与建议​

使用过程中遇到任何问题或有改进建议，欢迎提交 Issue：

提交时请附上以下信息以便快速排查：

  • GeneralUpdate 版本号（如 v10.5.0-rc.1）
  • 平台（Windows / Linux / macOS）
  • 更新策略（标准 / OSS / 静默 / 差分 / 推送）
  • 完整错误日志（可从 Logs/generalupdate-trace-*.log 获取）

版本历史​

0.0.2-beta.1 — 2026-06-16​

Updated for GeneralUpdate v10.5.0-rc.1 API:

  • Configinfo → UpdateRequest (namespace: GeneralUpdate.Core.Configuration)
  • Event args moved to GeneralUpdate.Core.Download and GeneralUpdate.Core.Event
  • Added SetSource(), SetOption(), Hooks<T>(), Strategy<T>() API coverage
  • Updated all strategy examples to use the new API
  • Updated CustomHooks.cs and CustomStrategy.cs to show v10.5 capabilities
  • Fixed IsComplated → IsCompleted
  • NuGet version bumped to 10.5.0-rc.1
  • Added 2 new skills: generalupdate-migration, generalupdate-security-audit

0.0.1-beta.1 — 2026-06-16​

Initial beta release. All templates rewritten for NuGet v10.4.6 stable API.

相关项目​