Agent Skills
› robinebers/openusage
robinebers/openusage
GitHub指导在macOS开发中如何桥接SwiftUI与AppKit，通过NSViewRepresentable等最小化边界实现原生行为，明确数据流与生命周期管理。
安装全部 Skills
npx skills add robinebers/openusage --all -g -y
集合内 Skills (27)
指导在macOS开发中如何桥接SwiftUI与AppKit，通过NSViewRepresentable等最小化边界实现原生行为，明确数据流与生命周期管理。
需要访问NSWindow或响应者链
实现NSViewRepresentable或NSViewControllerRepresentable
处理菜单验证、面板展示或拖放等桌面行为
npx skills add robinebers/openusage --skill appkit-interop -g -y
为 macOS 项目创建或更新本地构建运行脚本，自动适配 Xcode 或 SwiftPM 环境，实现停止、构建及启动应用流程，支持调试等模式。
用户请求创建或更新 macOS 应用的构建运行脚本
需要配置项目的默认构建和运行入口点
npx skills add robinebers/openusage --skill build-and-run-macos-app -g -y
提供 macOS 本地应用的构建、运行与调试工作流。支持 Xcode 和 SwiftPM，自动创建脚本来处理编译、启动及进程管理，并集成 lldb 调试、日志流查看等诊断功能，专注桌面端开发体验。
需要构建或运行 macOS 应用
排查编译器、链接器错误或启动问题
调试桌面端运行时异常
npx skills add robinebers/openusage --skill build-run-debug -g -y
用于诊断 macOS 应用代码签名或权限失败问题，通过检查 bundle、身份及策略，提供最小修复路径或验证命令。
macOS 应用签名报错
Entitlements 配置异常
Notarization 失败排查
npx skills add robinebers/openusage --skill fix-codesign-error -g -y
指导在 macOS SwiftUI 中实现、重构或审查 Liquid Glass 设计系统。涵盖 NavigationSplitView、工具栏、搜索及自定义玻璃效果的使用，强调移除自定义背景以适配系统材质，确保视觉与交互一致性。
需要实现 macOS SwiftUI 的 Liquid Glass 视觉效果
重构现有 UI 以符合现代 macOS 设计规范
审查 SwiftUI 界面是否过度使用自定义背景或材质
npx skills add robinebers/openusage --skill liquid-glass -g -y
指导在 macOS 开发中，当 SwiftUI 无法满足原生需求时，如何以最小化桥接方式与 AppKit 交互。涵盖 Representables、窗口面板、菜单及响应者链的使用规范，强调保持数据源单一和生命周期安全。
实现 SwiftUI 与 AppKit 的互操作
处理 NSWindow、菜单或拖拽等原生功能
需要访问第一响应者链
npx skills add robinebers/openusage --skill macos-appkit-interop -g -y
提供macOS应用构建、运行和调试的Shell优先工作流。自动识别Xcode或SwiftPM项目，生成统一入口脚本处理启动、终止及日志查看，支持lldb调试与进程验证，避免依赖模拟器。
需要构建并运行macOS应用
诊断应用启动或运行时故障
配置项目本地化构建运行脚本
npx skills add robinebers/openusage --skill macos-build-run-debug -g -y
指导在 macOS SwiftUI 应用中实现 Liquid Glass 设计系统，规范 UI 结构、工具栏及自定义玻璃效果，确保视觉连贯性与交互可用性。
需要实现 macOS SwiftUI 的 Liquid Glass 视觉效果
移除冲突的自定义 Chrome 或背景层
构建特定的玻璃表面组件
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应用启动失败
代码签名验证错误
权限配置异常
npx skills add robinebers/openusage --skill macos-signing-entitlements -g -y
用于在 macOS 环境下使用 SwiftPM 构建、运行和测试 Swift 包。当仓库以 Package.swift 为主或无 Xcode 项目时，提供标准化的包检查、编译、执行及测试流程，并协助分析构建失败原因。
需要构建 Swift 包
需要运行 Swift 可执行文件
需要测试 Swift 包
仓库没有 Xcode 项目
npx skills add robinebers/openusage --skill macos-swiftpm -g -y
指导在 macOS 上使用 SwiftUI 构建桌面应用，涵盖窗口、工具栏、设置等场景的布局模式与组件实现。提供现有项目适配及新应用脚手架搭建的最佳实践，确保遵循 Apple 设计规范。
需要构建 macOS SwiftUI 界面或组件
设计 macOS 应用的窗口结构和交互模型
为新应用搭建 SwiftUI 项目脚手架
npx skills add robinebers/openusage --skill macos-swiftui-patterns -g -y
指导在 macOS 应用中添加轻量级运行时遥测数据，使用 OSLog 框架记录关键行为以辅助调试。涵盖日志规范、最小化实现模式及验证流程，确保可观测性且不泄露敏感信息。
需要为 macOS 应用添加运行时日志或遥测功能
需要检查或验证特定 UI 组件（如侧边栏、菜单）的行为日志
npx skills add robinebers/openusage --skill macos-telemetry -g -y
用于 macOS 测试分类与故障排查，支持 Xcode 和 SwiftPM。通过缩小测试范围、精确分类失败类型（如构建错误、断言失败、崩溃等），并智能重跑以定位问题根源，避免将测试失败误判为产品缺陷。
macOS 测试失败分析
区分测试环境与产品 bug
Xcode 或 SwiftPM 测试用例调试
npx skills add robinebers/openusage --skill macos-test-triage -g -y
指导 macOS SwiftUI 视图重构，通过拆分大文件、明确场景结构、规范代码组织及限制 AppKit 使用，提升界面稳定性与可维护性。
拆分大型 SwiftUI 视图
优化 macOS 应用场景状态管理
规范 Swift 文件结构与职责分离
npx skills add robinebers/openusage --skill macos-view-refactor -g -y
指导在macOS SwiftUI中定制窗口行为，包括场景分类、工具栏与标题隐藏、拖拽区域扩展、窗口恢复及放置策略。提供从基础修饰符到AppKit桥接的完整工作流，确保窗口符合特定角色需求。
需要自定义macOS SwiftUI窗口外观或行为
调整窗口工具栏、拖拽区域或启动行为
npx skills add robinebers/openusage --skill macos-window-management -g -y
处理 macOS 应用打包、签名及公证工作流，解决归档构建、分发验证及公证失败问题。
准备 macOS 应用归档
验证应用包结构
排查公证就绪状态或失败原因
npx skills add robinebers/openusage --skill packaging-notarization -g -y
同步Cursor模型定价，拉取官方文档与本地补充文件比对，更新价格、别名及乘数，验证后提交PR。
Cursor新增或调整模型价格
计费模块显示未定价警告
定期执行定价核对
npx skills add robinebers/openusage --skill pricing-update -g -y
诊断 macOS 应用代码签名、权限、沙盒及 Gatekeeper 问题，提供修复路径。
诊断代码签名失败
检查缺失的权限
排查沙盒问题
分析 Gatekeeper 信任策略错误
npx skills add robinebers/openusage --skill signing-entitlements -g -y
基于 GPT 6.1 Sol 对代码变更进行多轮审查，直至通过或预算耗尽。适用于用户请求“sol loop”或发货前的独立审查场景，强调最小化改动与严格范围控制。
用户明确说 sol loop
用户要求在发货前进行 Sol 审查循环
npx skills add robinebers/openusage --skill sol-loop -g -y
用于在 macOS 环境下通过 SwiftPM 构建、运行和测试纯 Swift 包。适用于无 Xcode 项目或需快速复现的场景，提供从包检查到失败总结的标准化工作流。
需要构建或运行基于 SwiftPM 的 macOS 包
仓库以 Package.swift 为主要入口且无 Xcode 项目
需要诊断 Swift 包的编译或依赖问题
npx skills add robinebers/openusage --skill swiftpm-macos -g -y
提供 macOS SwiftUI 原生应用开发的最佳实践与示例，涵盖窗口、菜单、设置等组件模式。指导新建项目脚手架搭建及现有项目重构，确保遵循桌面端特定交互规范与架构设计。
创建新的 macOS SwiftUI 应用结构
重构或优化现有 SwiftUI 界面与场景
选择正确的 Scene 模型（如 WindowGroup, Settings）
实现菜单栏扩展或键盘驱动工作流
npx skills add robinebers/openusage --skill swiftui-patterns -g -y
为 macOS 应用添加轻量级运行时遥测和调试日志，使用 OSLog 框架记录关键行为并验证事件触发。
需要添加应用行为日志时
排查运行时问题需读取日志时
npx skills add robinebers/openusage --skill telemetry -g -y
通过最小化测试范围执行 macOS 应用测试，并分类解释失败原因。支持指定 scheme、target 等参数，区分编译与运行错误，提供修复建议。
用户显式调用 /test-macos-app 命令
需要针对 macOS 应用进行针对性测试和故障排查
npx skills add robinebers/openusage --skill test-macos-app -g -y
用于 macOS 测试故障排查，支持 Xcode 和 SwiftPM。通过缩小测试范围、分类失败类型（构建、断言、崩溃等）并智能重跑，区分真实回归与环境问题，提供清晰的失败总结和修复建议。
运行 macOS 测试
分析测试失败原因
区分真实回归与环境问题
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窗口外观
调整macOS窗口工具栏或标题显示
配置窗口拖拽和大小调整行为
npx skills add robinebers/openusage --skill window-management -g -y
