Agent Skills
› robinebers/openusage
robinebers/openusage
GitHub指导在 macOS 开发中如何桥接 SwiftUI 与 AppKit，提供选择最小化桥接方案、明确数据所有权及生命周期管理的最佳实践。
Install All Skills
npx skills add robinebers/openusage --all -g -y
Skills in Collection (26)
指导在 macOS 开发中如何桥接 SwiftUI 与 AppKit，提供选择最小化桥接方案、明确数据所有权及生命周期管理的最佳实践。
实现 NSViewRepresentable 或 NSViewControllerRepresentable
处理 SwiftUI 无法直接支持的窗口行为、菜单验证或拖放功能
npx skills add robinebers/openusage --skill appkit-interop -g -y
为 macOS 项目创建或更新本地构建运行脚本，自动检测 Xcode 或 SwiftPM 环境，实现停止、构建、启动流程，支持调试、日志等模式。
用户需要自动化 macOS 应用的构建和启动流程
项目缺少统一的 build_and_run.sh 入口脚本
npx skills add robinebers/openusage --skill build-and-run-macos-app -g -y
提供macOS本地应用的构建、运行与调试自动化流程。通过生成shell脚本统一处理Xcode和SwiftPM项目的编译启动，支持lldb调试、日志流查看及进程验证，专注桌面端而非移动端。
需要构建并运行macOS应用
诊断编译器或链接器错误
排查应用启动失败问题
调试桌面端运行时异常
npx skills add robinebers/openusage --skill build-run-debug -g -y
用于诊断 macOS 应用签名或权限失败问题，分析具体错误类型并提供最小修复路径或验证命令。
macOS 应用签名报错
entitlements 配置异常
npx skills add robinebers/openusage --skill fix-codesign-error -g -y
指导 macOS SwiftUI 应用适配 Liquid Glass 设计系统，优化导航、工具栏及自定义玻璃效果，移除冲突背景以提升视觉一致性与可用性。
macOS SwiftUI UI 现代化改造
实现或审查 Liquid Glass 视觉效果
优化 NavigationSplitView 和工具栏布局
npx skills add robinebers/openusage --skill liquid-glass -g -y
提供 macOS SwiftUI 与 AppKit 互操作的指导，帮助开发者在需要原生行为时选择最小化桥接方案，涵盖 Representable、窗口访问、菜单验证等场景，确保状态所有权清晰及生命周期安全。
实现 SwiftUI 到 AppKit 的桥接
处理 NSWindow 或面板交互
管理 macOS 菜单栏或响应者链
npx skills add robinebers/openusage --skill macos-appkit-interop -g -y
提供macOS应用构建、运行与调试的Shell优先工作流，自动生成统一入口脚本以简化Xcode和SwiftPM项目的启动流程，支持断点调试、日志流及进程验证。
需要构建并运行macOS应用
诊断应用启动或运行时故障
配置项目本地化构建脚本
npx skills add robinebers/openusage --skill macos-build-run-debug -g -y
指导在 macOS SwiftUI 应用中实现 Liquid Glass UI，规范系统玻璃效果使用，移除冲突自定义样式，优化导航与工具栏结构。
需要实现 macOS SwiftUI Liquid Glass UI
审查或重构 macOS 应用界面以符合现代设计规范
npx skills add robinebers/openusage --skill macos-liquid-glass -g -y
用于准备 macOS 应用打包和公证工作流。适用于归档应用、验证捆绑包或解释分发失败场景，指导检查签名、硬运行时及公证就绪状态。
macOS 应用归档与打包
应用公证流程与故障排查
npx skills add robinebers/openusage --skill macos-packaging-notarization -g -y
用于诊断 macOS 代码签名、权限和 Gatekeeper 问题。通过检查应用包和二进制文件，分析签名状态、权限不匹配或沙箱错误，并提供修复方案。
macOS 应用启动失败
代码签名验证错误
权限缺失或不匹配
沙箱运行时问题
Gatekeeper 信任拒绝
npx skills add robinebers/openusage --skill macos-signing-entitlements -g -y
用于在 macOS 环境下通过 Swift Package Manager 构建、运行和测试 Swift 包。当仓库以 Package.swift 为主或无 Xcode 项目时使用，涵盖包检查、编译、执行及测试结果分析。
需要构建 SwiftPM 包
运行 Swift 可执行文件
测试 Swift 包
npx skills add robinebers/openusage --skill macos-swiftpm -g -y
指导构建macOS SwiftUI应用，涵盖窗口、工具栏、设置等桌面组件模式。适用于现有项目功能开发或新应用脚手架搭建，强调场景模型选择、文件结构规范及系统适配。
需要创建新的macOS SwiftUI应用结构
实现macOS特有的UI组件如菜单栏、分割视图
优化现有SwiftUI应用的桌面交互体验
npx skills add robinebers/openusage --skill macos-swiftui-patterns -g -y
指导在 macOS 应用中集成轻量级运行时遥测，使用 OSLog 框架记录关键行为日志，并提供构建、运行及验证流程，确保可观测性且不泄露敏感数据。
需要添加应用行为日志
排查 UI 或命令执行问题
验证遥测事件是否触发
npx skills add robinebers/openusage --skill macos-telemetry -g -y
用于 macOS 测试故障分类与排查，通过最小化测试范围精准定位构建、断言或崩溃等失败原因，区分环境设置问题与回归缺陷，提供清晰的复现步骤与修复建议。
macOS 测试失败分析
Xcode 或 SwiftPM 测试用例归类
区分测试 flake 与真实 bug
npx skills add robinebers/openusage --skill macos-test-triage -g -y
指导 macOS SwiftUI 视图重构，强调拆分大型视图、规范文件结构及明确场景状态。适用于优化界面组件、提取子视图和稳定布局架构。
拆分大型 SwiftUI 视图
重构 macOS 应用界面结构
规范视图文件组织与命名
npx skills add robinebers/openusage --skill macos-view-refactor -g -y
指导如何定制 macOS SwiftUI 窗口的行为，包括窗口场景分类、工具栏与标题自定义、拖拽区域处理、窗口恢复与放置策略。适用于需要精细控制窗口外观和交互行为的开发任务。
需要隐藏或自定义 SwiftUI 窗口工具栏/标题时
调整窗口拖拽区域以支持无边框设计时
配置窗口最小化、恢复或初始位置行为时
npx skills add robinebers/openusage --skill macos-window-management -g -y
用于 macOS 应用打包、签名及公证流程的准备与故障排除。指导验证应用包结构、检查代码签名和权限，分析公证就绪状态或失败原因，并提供具体的修复步骤。
归档 Mac 应用
验证应用包结构
排查公证失败问题
npx skills add robinebers/openusage --skill packaging-notarization -g -y
同步Cursor模型定价，对比官方文档与本地JSON补充数据，更新价格、别名及乘数，验证后提交PR。用于处理新模型、重定价或无定价警告。
Cursor新增或重新定价模型
账单显示未定价模型警告
定期定价检查
npx skills add robinebers/openusage --skill pricing-update -g -y
诊断 macOS 应用代码签名、权限、沙盒及 Gatekeeper 问题。通过检查二进制文件和 plist，分类失败原因并提供修复命令，适用于启动拒绝或公证前置条件排查。
诊断代码签名失败
排查缺失权限或沙盒问题
分析 Gatekeeper 信任策略错误
npx skills add robinebers/openusage --skill signing-entitlements -g -y
用于纯SwiftPM macOS包的构建、运行和测试。当仓库以Package.swift为主入口或需快速诊断时，提供标准化的包检查、编译执行及失败分析流程。
需要构建或运行纯SwiftPM包
没有Xcode项目需快速复现问题
npx skills add robinebers/openusage --skill swiftpm-macos -g -y
提供macOS SwiftUI应用开发的最佳实践与示例，涵盖窗口、菜单、设置等场景的搭建与重构指导。
创建新的macOS SwiftUI应用脚手架
重构现有SwiftUI界面或组件
选择macOS特定的UI场景模式
npx skills add robinebers/openusage --skill swiftui-patterns -g -y
指导在 macOS 应用中添加轻量级运行时遥测与调试日志，使用 OSLog 框架记录关键行为并验证事件触发。涵盖日志规范、最小化代码模式及通过 Console 或 log stream 进行运行时验证的完整工作流。
需要为 macOS 应用添加运行时日志或遥测功能
调试应用行为并验证特定事件是否触发
配置结构化日志以支持运行时过滤和排查
npx skills add robinebers/openusage --skill telemetry -g -y
用于执行最小化 macOS 测试范围并分类解释失败原因。支持指定 scheme、target 等参数，自动检测构建工具，区分编译与测试错误，提供针对性修复建议。
用户运行 macOS 应用测试
需要分析测试失败类别
快速定位构建或测试阻塞问题
npx skills add robinebers/openusage --skill test-macos-app -g -y
用于在macOS环境下对Xcode和SwiftPM测试进行故障分类与排查。通过缩小测试范围、识别构建/断言/崩溃等失败类型，区分真实回归与环境问题，提供清晰的失败原因及修复建议。
运行macOS测试
分析测试失败原因
区分真实bug与环境问题
npx skills add robinebers/openusage --skill test-triage -g -y
指导重构 macOS SwiftUI 视图，遵循小职责、稳定结构原则。拆分大文件，提取子视图，明确命令与工具栏归属，合理使用场景状态，并限制 AppKit 混用。
清理 macOS 视图文件
拆分过大的场景根视图
移除 iOS 中心主义模式
优化 SwiftUI 与 AppKit 混合架构
npx skills add robinebers/openusage --skill view-refactor -g -y
指导在 macOS 15+ SwiftUI 中定制窗口行为，包括隐藏工具栏、自定义拖拽区域、调整背景材质及窗口初始位置等。
需要隐藏或自定义 SwiftUI 窗口标题栏和工具栏
需要扩展窗口可拖拽区域
需要设置窗口默认位置或缩放行为
npx skills add robinebers/openusage --skill window-management -g -y
