# Avalonia Zafiro Development

> 使用 Zafiro 工具包进行 Avalonia UI 开发的强制技能、约定和行为规则。触发词：Avalonia开发、Zafiro工具包、跨平台UI、MVVM、ReactiveUI、DynamicData、C#桌面应用

- Skill: `kscz0000/avalonia-zafiro-development` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add kscz0000/avalonia-zafiro-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/avalonia-zafiro-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/avalonia-zafiro-development

---


# Avalonia Zafiro 开发

本技能定义了使用 Avalonia UI 和 Zafiro 工具包开发跨平台应用程序的强制约定和行为规则。这些规则优先考虑可维护性、正确性和函数式响应式方法。

## 核心支柱

1. **函数式响应式 MVVM**：使用 DynamicData 和 ReactiveUI 的纯 MVVM 逻辑。
2. **安全性与可预测性**：使用 `Result` 类型进行显式错误处理，避免使用异常进行流程控制。
3. **跨平台卓越性**：严格保持 ViewModel 独立于 Avalonia，优先组合而非继承。
4. **Zafiro 优先**：利用现有的 Zafiro 抽象和辅助工具以避免冗余。

## 指南

- [核心技术技能与架构](core-technical-skills.md)：基础技能和架构原则。
- [命名与编码标准](naming-standards.md)：命名、字段和错误处理规则。
- [Avalonia、Zafiro 与响应式规则](avalonia-reactive-rules.md)：UI、Zafiro 集成和 DynamicData 管道的具体指南。
- [Zafiro 快捷方式](zafiro-shortcuts.md)：常见 Rx/Zafiro 操作的简洁映射。
- [常见模式](patterns.md)：高级模式如 `RefreshableCollection` 和验证。

## 编写代码前的流程

1. **先搜索**：在代码库中搜索类似的实现或现有的 Zafiro 辅助工具。
2. **可复用扩展**：如果缺少辅助工具，建议创建新的可复用扩展方法，而不是内联复杂逻辑。
3. **响应式管道**：确保在适用的情况下使用 DynamicData 操作符而不是普通 Rx。

## 使用时机
本技能适用于执行概述中描述的工作流程或操作。

## 限制
- 仅当任务明确匹配上述描述的范围时使用本技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。