1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | native-feel-skill |
| 作者/维护者 | yetone（GitHub 个人开发者，8000+ followers，另有同类型技能项目 kill-ai-slop） |
| 来源链接 | https://github.com/yetone/native-feel-skill |
| 许可证 | MIT（仓库 LICENSE 原文已核实） |
| GitHub Stars | 1,866（GitHub API 获取） |
| Forks | 73（GitHub API 获取） |
| 最新版本 | 无正式 tag/release，以主分支 master 为准 |
| 安装方式 | 手动指示 Agent 克隆到技能目录，或 npx skills 一键安装（见第 10 章） |
2. 功能介绍与亮点
native-feel-skill 是一份关于“如何让跨平台桌面应用有原生手感”的架构决策指南，内容取材于 Raycast 官方发布的 2.0 技术深度解析博客，并结合对已发布的 Raycast Beta.app 二进制的逆向验证。
- 八条架构准则（philosophy）：如“把分界线放在渲染层”“拥抱平台而非与之竞争”等，每条准则都配有具体场景说明，用于解释后续架构决策“为什么这样选”。
- 四层架构：原生外壳（macOS 用 Swift/AppKit，Windows 用 C#/WPF）+ 系统 WebView（WKWebView/WebView2，承载共享的 React/TypeScript UI）+ 长驻 Node 后端 + Rust 核心（通过 UniFFI 生成的类型化绑定跨语言复用）。
- WebView 生存指南：整理了 WKWebView/WebView2 在隐藏窗口时的节流、启动白屏闪烁等具体故障现象及对应修复参数，是内容密度最高的一份参考文档。
- 内存真相文档：指出 Activity Monitor 常见的几种“内存虚高”误读方式，避免团队为假象做无谓优化。
- 两份可执行清单：
decision-tree.md（先判断这套架构是否适合你的项目，明确排除冷启动 <100ms 或常驻内存 <150MB 等场景）与ship-readiness.md（75 项上线前原生感审计）。
亮点在于：内容有据可查（引用 Raycast 官方公开博客 + 对已发布二进制的实测逆向），且主动给出“什么时候不该用这套架构”的判断依据，而非单向推销某种技术选型。
3. 适用场景
所属分类：工程效率与代码质量。 该技能的产出物是特定技术栈（原生外壳 + WebView + Node + Rust）的架构决策与编码取舍，聚焦 IPC 设计、WebView 治理、内存诊断等工程问题，而非界面视觉设计本身，故归入此类。
面向需要为 macOS 与 Windows（可选 Linux）打造“看起来像原生 App”的桌面应用（Launcher、生产力工具、AI 工作台等）的技术负责人与工程师；尤其适合已用 Electron/Tauri 起步、却被设计师或用户吐槽“网页感太重”，想知道该往哪个方向优化的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 明确给出安装到
~/.claude/skills/的路径，遵循 Agent Skills 开放标准的 SKILL.md 格式。 - Codex：未验证。仓库材料仅泛称“其他 Agent-Skill-aware runtimes”，未点名。
- OpenClaw：未验证。仓库材料未提及。
- Hermes Agent：未验证。仓库材料未提及。
5. 推荐理由
给几乎每个跨平台桌面项目都会纠结的 Electron/Tauri 选型问题，提供一份可执行、可审计的架构决策手册与上线审计清单，而不是又一篇框架安利文。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 1,866 stars（单体仓库，非合集，可直接归于本技能）；发布后一周内进入第三方趋势追踪平台 Trendshift 的日榜第 8 名，随后有中文科技资讯站转载介绍；GitHub 层面未见独立用户讨论帖 |
| 可用性 | 8 | SKILL.md + 7 份 references + 2 份 checklists 结构完整，手动克隆或 npx skills 一条命令即可安装；最近一次提交在近 2 个月内；无任何付费依赖 |
| 安全性 | 9 | 纯文档/checklist 类技能，Agent 只读取 Markdown 文本给建议，无 shell 命令执行、无自身网络外发、不索取任何凭据；License 明确（MIT）；作者身份公开可查，无刷星或虚假宣传迹象 |
综合评分（三项均值）：8.0
安全检查清单逐项结果：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 无——技能本身不包含任何脚本，仅为 Agent 提供参考文本 |
| ② 联网外发数据 | 技能自身运行时无网络请求；仅在选择 npx skills 这一种安装方式时，经由第三方安装器联网（见第 11 章披露） |
| ③ API Key / 凭据 | 不需要任何 API Key 或凭据 |
| ④ 可疑指令 | 已读取 SKILL.md 与全部 README 原文，未发现提示注入或隐藏指令迹象 |
| ⑤ 作者信誉 | 个人开发者身份公开，GitHub 主页可查证，另有同类型技能项目，无刷星或虚假宣传迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 近 2 个月内有提交，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| 各类 Tauri/Electron 专项技能（社区常见的 tauri-desktop、electron-pro 一类） | 教你如何用 Tauri 或 Electron 框架把跨平台桌面项目搭起来，覆盖项目搭建、插件系统、打包分发等 | 默认接受框架自带的抽象层与“够用就好”的定位；本技能反而先给出决策树，判断这类框架的抽象层是否会挡住“原生感”目标，够不上要求时提供跳出框架、自建四层架构的方案 |
| 通用桌面开发指南类技能 | 覆盖窗口管理、打包、自动更新等桌面应用开发的通用工程环节 | 议题更宽泛但更浅，通常不深入 WebView 隐藏节流、类型化 IPC 跨语言绑定这类具体故障与实现细节 |
本技能的差异化在于：它不是“教你用某个框架”，而是先给出一套可执行的决策树排除不适用场景，再给出具体到 WebView 配置项、IPC 类型绑定方式的落地细节，且全部结论可追溯到 Raycast 官方博客与对已发布二进制的逆向验证。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub 仓库自身的提交历史显示仅有两条文档措辞修正的合并请求。可查证到的外部引用是第三方 GitHub 趋势追踪平台 Trendshift 将其列入日榜，以及一篇中文科技资讯站的转载介绍（内容为对项目自述的转述，未见独立评价）。
9. 其他补充
- 该仓库发布后一周内（2026 年 5 月）进入 Trendshift 日榜第 8 名。
- 作者 yetone 名下另有一份定位相近的 Agent Skill 项目 kill-ai-slop（867 stars），显示其在“Agent Skill 类参考指南”这一品类上有持续产出。
10. 安装使用方式
方式一（推荐，绕开第三方安装器）：手动克隆到技能目录
按 README 给出的提示词，让 Agent 自行执行：
mkdir -p ~/.claude/skills
git clone https://github.com/yetone/native-feel-skill ~/.claude/skills/native-feel-cross-platform-desktop克隆完成后确认 SKILL.md、references/、checklists/ 三者均存在于该目录下。
方式二：使用 npx skills 一键安装
npx skills add yetone/native-feel-skill -g-g 表示全局安装，所有项目均可复用；该方式依赖第三方 CLI 工具，见第 11 章披露。
安装后无需重启。技能会在对话涉及“cross-platform desktop”、“Electron alternative”、“Tauri vs native”、“WebView wrapper”、“WKWebView”、“Raycast architecture”等触发词时自动激活；也可直接要求 Agent 阅读 checklists/decision-tree.md 或 checklists/ship-readiness.md 来强制调用对应清单。
11. 注意事项
- 第 10 章“方式二”所用的
npx skills依赖第三方安装器 vercel-labs/skills，该仓库目前有两个尚未关闭的 issue（#1817、#699），指控其在安装过程中存在未经明确同意的遥测/审计数据上报。本技能自身不包含任何代码执行或网络请求，且 README 同等篇幅提供了不经过该 CLI 的手动克隆方式（见第 10 章方式一），可作为替代。 - 内容假设读者具备一定桌面客户端工程背景（Swift/AppKit、C#/WPF、Rust、WebView），面向的是“架构决策”而非“从零教你写桌面应用”，非本领域工程师直接使用门槛偏高。
- 该架构对冷启动预算 <100ms、常驻内存 <150MB 的项目并不适用，技能自带的决策树会明确排除这类场景；跳过决策树直接套用可能得到不合适的方案。
- 技能自述“不适用于”游戏、文档编辑器、媒体播放器等其他类型的桌面应用，聚焦范围单一。