gpui-skills
为使用GPUI框架开发桌面应用的开发者提供最佳实践指导。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：gpui-skills。 它的用途是：为使用GPUI框架开发桌面应用的开发者提供最佳实践指导。 完整的 Skill 内容见：https://321skill.com/skills/gpui-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我创建一个带有计数器状态的 GPUI 视图，并实现增加和减少的按钮。”，它会基于 gpui skill 中的状态管理和渲染规则，提供符合 GPUI 所有权模型的代码示例。或者问：“为什么我的异步数据加载在视图销毁后还在执行？”，它会引用 async 类别的规则，帮你分析 Task 生命周期管理的问题。
介绍
GPUI Skills 是一个专为 Zed 编辑器底层 UI 框架 GPUI 设计的 AI Agent Skill 集合。它旨在解决开发者在构建 GPUI 桌面应用时遇到的核心概念理解、状态管理、异步处理、组件构建等复杂问题，提供从入门到精通的实践指南。
使用方式非常简单，通过一行命令即可将技能库添加到你的 AI 编程助手（如 Claude、Cursor）中。之后，在编码过程中遇到任何与 GPUI 或 gpui-component 相关的问题，都可以直接向助手提问，它将基于技能库中的规则和最佳实践给出针对性建议。
这个技能库非常适合正在或计划使用 GPUI 框架进行桌面应用开发的前端、全栈或智能体开发者。无论你是刚接触 GPUI，需要理解其独特的所有权模型，还是正在构建复杂组件并需要遵循 gpui-component 的设计模式，它都能提供有效的帮助。
建议在使用时，结合具体的编码场景提问，例如直接描述你正在编写的视图或遇到的错误。技能库覆盖了从核心概念到反模式的多个方面，对于调试所有权、生命周期问题以及避免常见陷阱尤其有帮助。
核心特点
这是目前首个也是唯一一个专门针对 GPUI 框架及其生态库（gpui-component）的 AI Agent Skill，深度覆盖了 GPUI 特有的所有权模型、Entity 状态管理和异步任务处理等核心难点，而非泛泛的桌面开发指南。
注意事项
该技能仅适用于使用 GPUI 或 gpui-component 进行开发的场景，对于其他 UI 框架（如 Tauri、Electron）或通用前端开发问题帮助有限。
常见问题
如何解决 GPUI 中 Task 被意外取消的问题？
检查任务生命周期，确保使用 .detach() 或正确存储 Task 引用，避免在未完成时被丢弃。
GPUI 中状态更新后界面不刷新怎么办？
确认在修改 Entity 状态后调用了 cx.notify() 方法来通知上下文进行重新渲染。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gpui-skills/raw/index.md 读取 gpui-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gpui-skills/raw/index.md（查看排版版本）