Agent Skills
› robinebers/openusage
robinebers/openusage
GitHub指导在 macOS 开发中，当 SwiftUI 无法满足原生行为时，如何最小化地使用 AppKit 进行桥接。涵盖 NSViewRepresentable、窗口访问、菜单验证及拖放等场景的最佳实践与架构边界。
Install All Skills
npx skills add robinebers/openusage --all -g -y
Skills in Collection (26)
指导在 macOS 开发中，当 SwiftUI 无法满足原生行为时，如何最小化地使用 AppKit 进行桥接。涵盖 NSViewRepresentable、窗口访问、菜单验证及拖放等场景的最佳实践与架构边界。
实现 NSViewRepresentable 或 NSViewControllerRepresentable
需要访问 NSWindow 或响应者链
处理 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本地应用及桌面可执行文件的构建、运行与调试能力，支持Xcode和SwiftPM工作流，自动化编译启动流程并集成lldb等调试工具。
构建macOS应用
诊断编译器或链接器失败
调试桌面端运行时问题
启动本地App
npx skills add robinebers/openusage --skill build-run-debug -g -y
分析macOS签名或权限错误，诊断失败原因并提供最小修复方案。支持检查应用包、可执行文件及签名信息，区分开发、分发或公证问题，推荐可验证命令。
macOS应用签名失败
entitlements权限配置错误
代码签名证书或provisioning profile问题
npx skills add robinebers/openusage --skill fix-codesign-error -g -y
指导在 macOS SwiftUI 中实现 Liquid Glass 设计系统，包括重构 UI、移除自定义背景、使用玻璃效果及优化导航和工具栏结构。
需要应用或更新 macOS SwiftUI 的 Liquid Glass 视觉效果
重构现有 SwiftUI 界面以符合现代 macOS 设计规范
审查 SwiftUI 代码中的背景、工具栏和玻璃效果实现
npx skills add robinebers/openusage --skill liquid-glass -g -y
指导在 macOS 开发中如何桥接 SwiftUI 与 AppKit，处理窗口、菜单及拖拽等原生行为。
需要实现 NSViewRepresentable
访问 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 设计，移除自定义 Chrome，优化布局与工具栏，确保系统玻璃效果的正确应用。
实现 macOS SwiftUI 界面
审查或重构 UI 以适配 Liquid Glass
移除冲突的自定义背景或工具栏样式
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包。适用于无Xcode项目或Package.swift为主入口的场景，涵盖构建、执行及测试流程与故障排查。
需要构建SwiftPM包
需要运行Swift可执行文件
需要运行Swift测试
npx skills add robinebers/openusage --skill macos-swiftpm -g -y
指导构建 macOS SwiftUI 应用，涵盖窗口、工具栏等桌面模式。支持现有项目重构与新应用脚手架搭建，强调场景模型选择、文件结构规范及系统自适应设计。
需要构建或重构 macOS SwiftUI 界面
初始化新的 macOS Swift 应用项目
npx skills add robinebers/openusage --skill macos-swiftui-patterns -g -y
用于在 macOS 应用中添加和验证轻量级运行时遥测数据。指导使用 OSLog 框架记录结构化日志，涵盖窗口、侧边栏等关键行为，并提供构建运行及通过 Console.app 或命令行工具验证日志输出的工作流。
需要为 macOS 应用添加运行时监控或调试日志
需要验证特定 UI 操作或后台任务是否触发了预期日志事件
npx skills add robinebers/openusage --skill macos-telemetry -g -y
用于 macOS 测试分类与故障排查，支持 Xcode 和 SwiftPM。通过缩小测试范围、精确分类失败类型（如构建、断言、崩溃等）并智能重跑，高效定位问题根源，避免将测试失败误判为产品缺陷。
分析 macOS 测试失败原因
区分测试设置问题与回归缺陷
解释断言错误或崩溃日志
npx skills add robinebers/openusage --skill macos-test-triage -g -y
重构 macOS SwiftUI 视图与场景结构，遵循小且稳定的设计原则。规范文件组织、组件拆分及状态管理，限制 AppKit 使用，提升代码可维护性。
拆分大型 SwiftUI 视图
优化 Scene 状态管理
减少 AppKit 混用
npx skills add robinebers/openusage --skill macos-view-refactor -g -y
用于定制 macOS SwiftUI 窗口行为，包括调整窗口外观、拖拽区域、放置策略及恢复机制，确保各场景窗口符合特定交互需求。
需要自定义 SwiftUI 窗口 chrome 或标题栏样式
配置窗口拖拽区域或无边框行为
调整窗口启动、缩放或还原逻辑
npx skills add robinebers/openusage --skill macos-window-management -g -y
用于 macOS 应用的打包、签名及公证流程准备与故障排查。适用于归档验证、分发包结构检查、 hardened runtime 配置及公证失败原因分析，确保应用符合发布标准。
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 问题。通过 inspect 签名细节并分类故障，提供最小修复路径。
诊断代码签名失败
排查缺失权限或沙箱问题
检查 Gatekeeper 信任策略错误
npx skills add robinebers/openusage --skill signing-entitlements -g -y
用于在 macOS 环境下通过 SwiftPM 构建、运行和测试纯 Swift 包。适用于无 Xcode 项目或需快速诊断的场景，支持检查包结构、执行编译运行及测试并分析失败原因。
仓库以 Package.swift 为主入口
需要快速复现或诊断 Swift 包问题
用户明确要求使用 SwiftPM 而非 Xcode
npx skills add robinebers/openusage --skill swiftpm-macos -g -y
提供 macOS SwiftUI 应用的构建最佳实践与示例，涵盖窗口、菜单、设置等原生组件模式。指导开发者选择场景模型、搭建项目脚手架及组织文件结构，提升桌面端 UI 开发效率与规范性。
创建新的 macOS SwiftUI 应用
重构现有 SwiftUI 界面
设计 macOS 原生交互模式
npx skills add robinebers/openusage --skill swiftui-patterns -g -y
为 macOS 应用添加轻量级运行时遥测和调试日志，验证关键行为事件是否触发。指导使用 OSLog 框架进行结构化日志记录，并通过 Console.app 或 log stream 命令验证日志输出，确保可观测性且不泄露敏感数据。
需要添加应用调试日志
验证 UI 操作或后台任务的事件触发
排查运行时行为问题
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 测试
缩小失败测试范围
解释断言或崩溃原因
区分真实回归与环境问题
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 窗口管理技能，用于定制窗口场景、工具栏、拖拽区域及行为。
需要自定义 macOS SwiftUI 窗口样式或行为时
处理窗口工具栏隐藏、拖拽区域扩展或启动放置逻辑时
npx skills add robinebers/openusage --skill window-management -g -y
