欣淇
发布于 2026-05-18 / 0 阅读
0
0

🎯 native-feel.skill:1.3k Stars 的 Agent Skill,让你的 AI 不再产出"网页风"桌面应用

⚠️ Skill(s) not found and skipped: Halo 博客发布自动化

The Halo blog publishing automation skill was referenced but not available. Proceeding with manual workflow using the existing publish_and_fix.py script.

🎯 native-feel.skill:1.3k Stars 的 Agent Skill,让你的 AI 不再产出"网页风"桌面应用

你让 AI Agent 写个桌面应用,出来的东西一看就是网页套壳——白闪、滚动条不对、右键菜单露馅。这不是你的 prompt 不够好,是你的 Agent 缺了系统级的桌面开发知识

这个项目只有 1.3k Star,但我最近看到好几个同类方向都在引用它。它解决了一个真实痛点:当 Agent 要写跨平台桌面 App 时,怎么产出"看起来就是原生应用"的代码,而不是一套 Electron 裹布?

不是技能包,是架构说明书

native-feel.skill 不是一个教你调 WebView 参数的简单技能。它拆解了 Raycast 2.0 的技术架构——从 Raycast Beta.app 的二进制反编译里提炼出八条架构原则、四层架构、和一份 75 项的发布检查清单。

安装方式跟你装别的 Agent Skill 一样:

npx skills add yetone/native-feel-skill -g

或者手动丢进 Agent 的技能目录:

git clone https://github.com/yetone/native-feel-skill.git \
  ~/.claude/skills/native-feel-cross-platform-desktop

最有价值的几个模块

75 项原生感审计清单:你的 Electron 应用为什么一眼就能看出是网页?因为 cursor: pointer 在表格行上、WebKit 右键菜单没禁用、窗口背景用的是白色而不是系统材质。这 6-8 个最容易翻车的地方,每一项改起来不超过 30 分钟。

四层架构参考:Native Shell(Swift/AppKit + C#/WPF)→ System WebView(WKWebView/WebView2)→ Node 后端 → Rust 核心层。每层之间的 IPC 契约用一套 Schema + Codegen 生成,不手写胶水代码。

WebView 存活指南:WKWebView 闪烁、WebView2 内存泄漏、暗黑模式不跟随系统——这些坑逐一列出了解决顺序和实际代码。

最骚的操作

那个 IPC 契约的设计:一套 Schema 声明,自动生成 Swift、C#、TypeScript、Rust 四端的客户端代码。这比手写 JSON-RPC 或者 message-passing 稳太多了。

You  ❯ 我的 Electron 应用在 macOS 上看起来太网页了,设计师说不通过。
Agent ❯ 最快路径是跑 75 项审计。多数 Electron 应用倒在同样 6-8 项上
         ——改完每一项 5-30 分钟,就能通过"30 秒怀疑用户测试"。

不是万能药

项目 README 自己说得很清楚:这套架构不适合单平台应用(直接原生就行)、不适合 <150MB 内存或 <100ms 冷启动预算的应用、不适合游戏/文档编辑器。它解决的是"必须跨平台 + 必须看起来原生 + 得有插件生态"这个交集。

几点总结

  • 用 AI Agent 写桌面应用时,给 Agent 装这个技能,输出质量上一个台阶
  • 75 项审计清单可以单独拿来做 Code Review 标准
  • 四层架构适合 mid-stage 的跨平台产品参考
  • 如果只有一个点要带走:IPC 契约用 Schema + Codegen,别手写

先跑一遍决策树,确定你的项目是不是适合这套架构,再深挖。


🎯 native-feel.skill: 1.3k Stars Agent Skill That Teaches Your AI to Build Desktop Apps That Actually Feel Native

You ask your AI agent to build a desktop app, and it comes back looking like a web page in a chrome frame — white flash on launch, wrong scrollbars, the WebKit context menu still firing. It's not your prompt; your agent just doesn't know system-level desktop architecture.

This project has 1.3k stars but punches way above its weight. It solves one real problem: when your AI agent writes cross-platform desktop code, how do you make it produce something that passes the "looks native" test?

More Than a Skill Pack

native-feel.skill reverse-engineers Raycast 2.0's architecture — from the shipping Raycast Beta.app binary — distilling it into eight architectural tenets, a four-layer architecture, and a 75-item ship readiness checklist.

Install it like any Agent Skill:

npx skills add yetone/native-feel-skill -g

Or clone it into your agent's skill directory:

git clone https://github.com/yetone/native-feel-skill.git \
  ~/.claude/skills/native-feel-cross-platform-desktop

What's Inside

75-item native-feel audit: Most Electron apps fail the same 6-8 items. Each fix takes 5-30 minutes. Together they get you past the "30-second skeptical user test."

Four-layer architecture: Native Shell (Swift/AppKit + C#/WPF) → System WebView → Node backend → Rust core. One IPC schema, codegen for all runtimes.

WebView survival guide: White flash, memory leaks, dark mode quirks — every bug with fix order and code.

The Killer Feature

The IPC contract: one schema declaration generates client code for Swift, C#, TypeScript, and Rust. No hand-written glue, no JSON-RPC boilerplate.

When NOT to Use It

Single-platform apps (just build native), <150MB memory budget, <100ms cold-start requirements. This is for the cross-platform + native-feel + plugin ecosystem intersection.

TL;DR

  • Install this skill before asking your agent to write desktop UIs
  • The 75-item audit works standalone as a code review checklist
  • One IPC schema + codegen > hand-written message passing
  • Run the decision tree first — the skill rules itself out honestly

评论