技能使用指南

avalonia-viewmodels-zafiro（AvaloniaViewModelsZafiro开发技能Skill）Skill 是什么？

面向 Avalonia 桌面开发的 AI 技能，基于 Zafiro 与 ReactiveUI 生成可维护的 ViewModel、命令与多步骤 Wizard 流程，帮助团队统一导航、分区与依赖注入实践。了解安装方式、使用步骤、竞品对比与常见问题，快速提升开发效率。

AvaloniaViewModelsZafiro开发技能Skillavalonia-viewmodels-zafiro
8 个章节 约 17 分钟阅读 AI 智能生成

AvaloniaViewModelsZafiro开发技能Skill：用 Zafiro 与 ReactiveUI 构建可维护的 Avalonia ViewModel 与 Wizard 流程

  • 这是一个面向 Avalonia 桌面开发的 AI 技能，技能 ID 为 12248，核心是结合 Zafiro 与 ReactiveUI 生成更规范的 ViewModel、命令与多步骤 Wizard 流程。
  • 它强调功能反应式状态管理、IEnhancedCommand 增强命令、SlimWizard/WizardBuilder 向导模式、[Section] 自动分区发现，以及 DataTypeViewLocator 与 CompositionRoot 的清洁组合。
  • 适合正在使用或计划使用 Avalonia + Zafiro + ReactiveUI 的开发者、架构师和需要多步骤业务流程的产品团队。
  • 安装入口和具体命令因 AI 技能平台而异，技能详情未提供固定安装命令，实际以官方说明为准；安装后可通过生成 ViewModel 或询问 Wizard 模式来验证是否生效。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

该技能的中文名为 AvaloniaViewModelsZafiro开发技能Skill，英文名为 avalonia-viewmodels-zafiro，技能 ID 为 12248。它主要解决 Avalonia 应用在 ViewModel 设计、命令管理、多步骤 Wizard、导航分区和依赖组合方面缺少统一模式的问题。技能详情明确说明，它提供一套使用 Zafiro 和 ReactiveUI 创建 ViewModel、Wizard 和管理导航的最佳实践与模式。

所谓“一键安装 AI 技能”，通常是指在支持 AI 技能的客户端或平台中，通过技能市场、技能列表或技能入口搜索并启用该技能，让 AI 助手在后续对话中遵循该技能封装的专业知识。具体安装按钮、命令、入口和授权方式因平台不同而异，以官方说明为准。一般可以按以下思路操作：

  1. 确认使用环境：你使用的 AI 客户端或平台需要支持安装、启用 AI 技能；项目侧应使用 Avalonia，并计划采用 Zafiro 与 ReactiveUI。具体版本要求以官方说明为准。
  2. 搜索技能：在技能市场或技能列表中搜索英文名 avalonia-viewmodels-zafiro、中文名“AvaloniaViewModelsZafiro开发技能Skill”，或技能 ID 12248。
  3. 安装并启用：找到技能后点击安装或启用，并按平台要求完成授权。若平台提供“一键安装”按钮，按其提示操作即可；若没有，则使用平台提供的技能导入方式，具体以官方说明为准。
  4. 在会话中调用：启用后，在对话中选择该技能，或用自然语言说明“请按照 avalonia-viewmodels-zafiro 技能来设计 ViewModel/Wizard”。如果平台支持 @ 引用技能，按官方文档的方式引用。
  5. 验证是否生效：可以让 AI 助手解释 SlimWizard 与 WizardBuilder 的用途，或生成一个使用 ReactiveObject、WhenAnyValue 的 ViewModel。若回答中能体现 IEnhancedCommand、[Section]、DataTypeViewLocator、CompositionRoot 等关键模式，说明技能大概率已生效；如果回答仍然泛泛而谈，建议检查技能是否启用成功。

技能详情未提供具体安装命令、下载地址、价格或版本兼容表，因此这些信息应查看所在平台的官方说明，避免使用来源不明的命令。

2. 该技能的主要功能和特点

  • 功能反应式 ViewModel 设计：基于 ReactiveUI 的 ReactiveObject、WhenAnyValue 等能力处理状态和逻辑，让 ViewModel 的状态变化、派生属性和交互逻辑更清晰。
  • 增强命令管理：使用 IEnhancedCommand 管理命令，支持进度报告以及名称/文本属性，适合需要加载状态、提交状态和用户提示的业务操作。
  • Wizard 多步骤流程：通过 SlimWizard 和 WizardBuilder 以声明式方式构建复杂流程，降低多步骤表单、创建流程、配置流程的维护成本。
  • 自动部分发现：使用 [Section] 属性自动注册和发现 UI 部分，让导航与页面分区更规整，减少手工注册带来的遗漏。
  • 清洁组合与映射：使用 DataTypeViewLocator 将 ViewModel 映射到 View，并在 CompositionRoot 中管理依赖项，帮助团队统一依赖注入和视图定位方式。
  • 配套指南覆盖关键主题：技能详情列出 ViewModel 与命令、Wizard 与流程、导航与部分、组合与映射等指南文件，便于按主题深入。
  • 真实项目参考：技能详情建议参考 Angor 项目中的 CreateProjectFlowV2.cs 和 HomeViewModel.cs，分别对应复杂 Wizard 构建和简单分区 ViewModel 的实现思路。

和普通代码补全工具相比，它的差异不在于“能不能写 C#”，而在于把 Avalonia + Zafiro + ReactiveUI 的领域模式前置到生成过程中。普通工具可能给出一个能运行的 ViewModel，但不一定遵循 IEnhancedCommand、[Section]、DataTypeViewLocator 和 CompositionRoot 的组合方式；该技能更强调模式一致性、可维护性和流程级设计。

3. 如何使用该技能？

使用该技能时，建议把它当作“Avalonia ViewModel/Wizard 设计顾问 + 代码骨架生成器”，而不是完全自动交付完整项目。推荐步骤如下：

  1. 启用技能并说明技术栈：在对话中明确项目使用 Avalonia、Zafiro 和 ReactiveUI，并说明当前目标是创建 ViewModel、命令、Wizard，还是整理导航与依赖注入。
  2. 描述业务需求：给出页面名称、状态字段、用户操作、加载/错误状态、是否需要多步骤流程。例如：“请为项目管理页面创建 HomeViewModel，包含项目列表加载、搜索、刷新命令和进度状态。”
  3. 要求遵循技能原则：在提示中明确要求使用 ReactiveUI 的功能反应式写法、IEnhancedCommand、[Section]、DataTypeViewLocator 或 CompositionRoot 中适用的部分。
  4. 要求输出结构说明：除了代码，让 AI 说明 ViewModel 放在哪里、View 如何映射、命令如何绑定、Wizard 步骤如何组织、依赖如何注册。这样更便于落地。
  5. 校验并集成：把生成的代码放入项目后，检查命名空间、包版本、依赖注入注册、导航配置和 View 映射是否符合项目现状。技能提供的是模式指导，仍需要开发者结合项目实际调整。
  6. 按指南深入：如果涉及复杂流程，继续要求参考 wizards.md 的思路；如果涉及导航分区，参考 navigation_sections.md；如果涉及组合与映射，参考 composition.md。

输入示例一：

请按照 avalonia-viewmodels-zafiro 技能，为“项目列表页”创建 ViewModel。要求使用 ReactiveObject 和 WhenAnyValue 管理加载状态与搜索条件，提交和刷新命令使用 IEnhancedCommand，并说明如何通过 DataTypeViewLocator 映射到 View。

期望输出：ViewModel 类结构、属性和命令定义、状态订阅关系、View 映射说明，以及需要注册的依赖项。

输入示例二：

请使用 SlimWizard 和 WizardBuilder 设计一个“创建项目”三步向导：基本信息、成员配置、确认提交。每一步用 [Section] 标识，并说明导航与 CompositionRoot 中的依赖注册方式。

期望输出：Wizard 步骤划分、每步的 ViewModel 职责、WizardBuilder 的组织思路、分区注册方式，以及组合根中的依赖注册建议。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
avalonia-viewmodels-zafiro（本技能） 面向 Avalonia + Zafiro + ReactiveUI 的 ViewModel 与 Wizard 专项技能 功能反应式 ViewModel、IEnhancedCommand、SlimWizard/WizardBuilder、[Section]、DataTypeViewLocator、CompositionRoot 指导 需在支持 AI 技能的平台安装启用；项目需具备 Avalonia、Zafiro、ReactiveUI 基础；具体安装以官方说明为准 需要统一 ViewModel 模式、快速搭建多步骤向导、整理导航分区与依赖组合的团队 优势是领域针对性强、模式覆盖完整；不足是依赖特定技术栈，仍需要开发者审核和集成
原生 Avalonia + ReactiveUI 手写 直接使用基础框架自行组织 MVVM ReactiveObject、WhenAnyValue、命令、导航和依赖注入均自行实现 需要自行搭建项目规范，学习 ReactiveUI 用法 小型项目、希望完全掌控代码结构的团队 优势是可控性高；不足是样板代码多，Wizard、分区和组合方式容易不一致
Prism.Avalonia 面向 Avalonia 的模块化 MVVM 框架方案 区域导航、模块化、MVVM 基础设施等 需引入框架并学习区域、模块、导航等概念 大型模块化桌面应用、需要成熟导航体系的团队 优势是模块化能力成熟；不足是与 Zafiro/ReactiveUI 的专项组合不是本技能重点，可能需要额外适配
通用 AI 编程助手 通用代码生成与问答工具 可生成 C#、XAML、解释代码和排查问题 安装简单，通常无需特定领域技能 通用开发任务、快速问答、片段生成 优势是灵活；不足是缺少 Zafiro、ReactiveUI、Wizard、分区导航的专项约束，输出需要更多校正

选择时可以根据团队技术栈判断：如果项目已经使用 Zafiro 和 ReactiveUI，并希望 AI 输出更贴近既有模式，本技能更有针对性；如果项目采用 Prism 或自研 MVVM 体系，则应优先选择对应框架方案；如果只是偶尔生成代码片段，通用 AI 助手也能胜任，但需要人工把关模式一致性。

5. 该技能的典型应用场景与实际体验情况

场景一：Avalonia 桌面开发者快速搭建 CRUD 页面 ViewModel
角色是业务开发工程师，痛点是每个列表页、编辑页都要重复处理加载状态、搜索条件、提交命令和错误提示。使用方式是把页面字段和操作描述给 AI，并要求按该技能使用 ReactiveObject、WhenAnyValue 和 IEnhancedCommand 生成 ViewModel 骨架。实际体验上，这类任务上手难度中等，关键是提示中要写清楚状态和命令，否则生成结果可能过于通用。

场景二：产品团队需要多步骤创建向导
角色是产品经理与开发组合，痛点是一个“创建项目”或“配置服务”的流程包含多个步骤，手写 Wizard 容易出现步骤跳转、状态保存和返回逻辑分散的问题。使用方式是要求 AI 用 SlimWizard 和 WizardBuilder 拆分步骤，并用 [Section] 标识每一步。实际体验上，技能能帮助快速形成声明式流程结构，但仍需开发者确认导航顺序、校验规则和最终提交逻辑。

场景三：架构师统一导航、分区与依赖组合
角色是技术负责人或架构师，痛点是团队内 ViewModel 到 View 的映射方式不统一，依赖注册位置混乱。使用方式是让 AI 基于 DataTypeViewLocator 和 CompositionRoot 给出组合建议，并对照 navigation_sections.md、composition.md 梳理规范。实际体验上，这类任务更偏设计评审，生成结果适合作为讨论底稿，不宜直接替代架构决策。

场景四：参考 Angor 项目实现复杂流程
角色是维护复杂 Avalonia 项目的开发者，痛点是已有流程代码难以重构。技能详情建议参考 Angor 项目的 CreateProjectFlowV2.cs 和 HomeViewModel.cs，分别对应复杂 Wizard 和简单分区 ViewModel。使用方式是让 AI 对照这些示例解释模式，再迁移到当前项目。实际体验上，这有助于理解“为什么要这样组织”，但需要开发者具备阅读现有代码和调整依赖的能力。

整体来看，该技能的上手难度为中等：了解 Avalonia、C# 和 ReactiveUI 基本概念后更容易获得高质量结果。效果方面，它更适合生成“符合模式的骨架和设计说明”，而不是保证一次生成即可运行。注意事项包括：明确技术栈和版本、提供业务状态与命令清单、检查依赖注入和 View 映射、对 Wizard 流程进行实际导航测试。

6. 该技能能为用户带来的价值

提升开发效率：把 ViewModel、命令、Wizard、分区导航和组合映射的常见套路前置到 AI 生成阶段，减少从零搭骨架、反复补样板代码和来回讨论模式的时间。对于重复度较高的页面和多步骤流程，价值尤其明显。

降低模式使用门槛：Zafiro 与 ReactiveUI 的组合需要一定经验，尤其是 IEnhancedCommand、SlimWizard、[Section]、DataTypeViewLocator 和 CompositionRoot 的配合。该技能把这些概念组织成可复用的实践指南，让经验较少的开发者也能按相对统一的思路起步。

提高团队一致性：当多位开发者都通过同一技能生成或审查 ViewModel 与 Wizard 时，命令管理、导航分区和依赖组合更容易保持一致，减少“每个人一套写法”的维护成本。

长期可维护价值：技能强调功能反应式方法和清洁组合，不是为了追求短期代码量，而是为了让状态变化、命令进度、流程步骤和依赖关系更清晰。长期看，这有助于代码评审、重构和交接。可以用“减少重复样板代码、减少模式讨论轮次、缩短向导流程搭建时间”作为团队内部衡量收益的观察指标。

7. 常见问题 FAQ

Q1：这个技能怎么安装？
A：在支持 AI 技能的平台中搜索英文名 avalonia-viewmodels-zafiro、中文名“AvaloniaViewModelsZafiro开发技能Skill”或技能 ID 12248，然后按平台提示安装并启用。技能详情未提供固定安装命令和入口，具体以官方说明为准。

Q2：这个技能收费吗？
A：技能详情没有提供价格信息，因此无法确认是否收费。请以所在 AI 技能平台的官方说明、订阅规则或技能页面展示为准。

Q3：适合谁用？
A：适合使用 Avalonia 的 C# 桌面应用开发者、正在采用 Zafiro 与 ReactiveUI 的团队、需要统一 ViewModel/Wizard 模式的架构师，以及需要快速搭建多步骤业务流程的产品研发团队。如果项目不使用 Avalonia 或 Zafiro/ReactiveUI，该技能的针对性会明显下降。

Q4：它和普通 AI 编程助手有什么区别？
A：普通助手更偏向通用代码生成；该技能把 Zafiro、ReactiveUI、IEnhancedCommand、SlimWizard、[Section]、DataTypeViewLocator 和 CompositionRoot 等专项模式注入生成过程，输出更贴近 Avalonia 项目的既有架构，但仍需要开发者审核。

Q5：生成的代码能直接运行吗？
A：不能默认保证。技能提供的是模式、指南和代码骨架，实际运行还取决于项目版本、命名空间、依赖注入注册、导航配置和 View 映射。建议把生成结果当作高质量初稿，经过编译、单元测试和实际导航验证后再合入项目。