Menu
macOS 桌面 App (apps/mac, Swift/SwiftPM) 的构建、测试、打包安装与 CI 验证。当要 build/test mac app、装到 /Applications、出 .app 包、排查 mac 编译/CI 失败、或发 mac 版时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | mac-build-deploy |
| description | macOS 桌面 App (apps/mac, Swift/SwiftPM) 的构建、测试、打包安装与 CI 验证。当要 build/test mac app、装到 /Applications、出 .app 包、排查 mac 编译/CI 失败、或发 mac 版时使用。 |
apps/mac/(Swift 6 + SwiftUI,SwiftPM 包)的开发反馈环 + 分发。backend-engineer/mac-engineer/qa-verifier/release-engineer 共用。
cd apps/mac
swift build # 编译
swift test --filter HealthAgentMacCoreTests # 逻辑/核心测试 (CI 同款)
HealthAgentMacTests 只在本地手动跑(像素 diff 受字体/抗锯齿影响,CI 跑会假红)。HealthAgentMacCore(库 = 可测);视图层薄。scripts/package-app.sh # 出 apps/mac/dist/HealthAgentMac.app (ad-hoc 签名, 不入库)
scripts/package-app.sh --install # 同时装到 /Applications
scripts/package-app.sh --open # 打包后直接打开
scripts/package-app.sh --debug # debug 配置
产物 apps/mac/dist/ 不提交。显示名见 Info.plist;App 直连生产 https://health.executor.life/api/v1。
CI mac-build job:macos-latest + setup-xcode@v1 latest-stable(pin)→ swift build + swift test --filter HealthAgentMacCoreTests。
CI 的 Xcode/工具链常比本地旧,会暴露本地不报的编译错(类型检查超时 / main-actor 隔离 / 跨模块 init)。提交前若改了 Swift,必须以 CI 结果为准;反复本地绿但 CI 红时,对照 mac-engineer agent 的"必踩坑"清单逐条排查。
| CI 报错 | 根因 | 修法 |
|---|---|---|
unable to type-check in reasonable time | 长链三元 / 多重 ?? 嵌套 | 拆成 if/else + 单 ?? 链 |
main actor-isolated ... can not be referenced | 自由 some View 函数 | 给函数/类型加 @MainActor |
跨模块测试 missing 'from' | Core 的 public struct 用了隐式 internal init | 加显式 public init |
| 运行时崩溃(启动即崩) | AppLocalization 重复 key | 加条目前查重 |
当前仅 ad-hoc 本地签名。要上 TestFlight / Developer ID 需建 Xcode App target(指向同一 Sources/)+ 换正式签名 —— 这是未来工作,现在不要假装能直接发商店。
管理首页行动卡片 — 创建、查询、完成、归档。当用户想把某条建议固化到首页、查看当前行动计划、标记完成，使用这个 skill。
Assess chronic disease risk — cardiovascular (modified Framingham), metabolic syndrome (IDF criteria), and 90-day trend analysis. Integrates wearable data (Garmin), labs, vitals, and genetic markers for personalized risk scoring with confidence intervals.
Family health management - medical reports, medications, review calendar, family daily health check. Use when user asks about family members' health, medical exams, medications, checkup schedules, or wants to manage health for parents/spouse/children.
Query and analyze user genetic test data (基因检测). Cross-reference genetics with medical reports, Garmin wearable data, and current health status for personalized nutrition, exercise, drug sensitivity, disease risk, and sleep advice.
Get AI health analysis, daily recommendations, health trend predictions, and health scores. Use when the user asks for health advice, trend analysis, risk assessment, or wellness recommendations.
综合查询健康数据 — Digital Health Twin 快照、Safety 告警、长期趋势、Orchestrator 多专家分析。当用户想了解自己的整体健康状况、趋势变化、安全风险时使用。