FloWritesCode/fwc-swiftui-skills

概述

FWC SwiftUI Skills 是一系列 Agent Skills（智能体技能）的集合——这些是小型、可重用的知识模块，可以加载到诸如 Cursor、Claude Code、Codex 或任何支持 Agent Skills 规范 的 AI 代码辅助工具中。每项技能都会指导智能体如何为最新的 iOS 特性生成、审查或适配 SwiftUI 代码：

• swiftui-liquid-glass – 帮助模型处理 iOS 26 的“Liquid Glass”（液态玻璃）视觉效果 API，涵盖常见模式和陷阱。
• swiftui-iphone-duo – 指导模型为即将推出的 iPhone Duo（iOS 27.1 SDK）构建适配折叠屏的 UI，包括铰链交互和摄像头配件。

该仓库不包含可运行的应用程序或机器学习模型；它提供的是结构化文档，AI 智能体可以通过这些文档来提升其 SwiftUI 代码生成能力。

---

安装与使用

1. 通过 Skills CLI（推荐） – Vercel-Labs 的 skills 命令可以获取整个包或单个技能，并将其放入 AI 辅助工具的相应目录中。

   # 安装所有内容（如果您的 CLI 支持）
   npx skills add FloWritesCode/fwc-swiftui-skills
   
   # 仅安装一个技能
   npx skills add FloWritesCode/fwc-swiftui-skills --skill swiftui-liquid-glass
   

2. 手动复制 – 克隆仓库并将所需的技能文件夹复制到智能体的 ~/.agents/skills/（或工具特定的路径，如 ~/.cursor/skills/）中。

   git clone https://github.com/FloWritesCode/fwc-swiftui-skills.git
   cp -R fwc-swiftui-skills/skills/swiftui-liquid-glass ~/.agents/skills/
   

安装完成后，当您要求 AI 辅助工具编写或审查使用这些 iOS API 的 SwiftUI 代码时，它便可以参考 SKILL.md 的元数据（front-matter）以及任何可选的 reference.md。

---

核心概念

概念	对用户的意义
Agent Skill	一个微小的、自包含的知识包（YAML 元数据 + 可选文档），AI 代码辅助工具可以自动加载并应用它。
Liquid Glass	iOS 26 中引入的一种视觉效果；该技能包含最新的原生 API 用法、模式和常见错误。
iPhone Duo	一款假想的折叠屏 iPhone（iOS 27.1 SDK）。该技能教授如何处理铰链、动态尺寸类（dynamic size classes）以及内置摄像头配件的布局策略。
Skills CLI	一个命令行工具（npx skills），用于获取这些包并将其安装到 Cursor、Claude Code 或 Codex 等智能体监控的目录中。

---

典型工作流程

1. 添加技能：使用 CLI 或手动复制将技能添加到您首选的 AI 辅助工具中。
2. 提示智能体：例如，“创建一个使用 Liquid Glass 模糊效果的 SwiftUI 视图。”
3. 智能体读取 swiftui-liquid-glass 技能，提取记录的模式，并生成符合最新 iOS 26 指南的代码。
4. 如果需要审查，请询问“检查我的 SwiftUI 视图是否存在 Liquid Glass 方面的陷阱”，智能体将交叉参考同一技能来发现问题。

---

适用人群

• iOS 开发者：希望 AI 助手能够跟上最新的 SDK 特性，而无需手动翻阅 Apple 文档。
• 团队负责人：希望标准化 AI 生成的代码如何处理新兴的 UI 范式（折叠设备、新视觉效果）。
• 工具构建者：希望获得一个现成的 Agent Skills 格式示例，用于 SwiftUI 相关的知识库。

---

许可证

MIT – 可自由使用、修改和重新分发。

---

以上所有信息均直接摘自该仓库的 README；未推断出任何额外功能。