metame-cli 1.5.11 → 1.5.12

package/skills/heartbeat-task-manager/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: heartbeat-task-manager
+description: |
+  管理 MetaMe Desktop 的心跳任务（提醒任务）。
+  当用户说“每天提醒我…”、“6点提醒我…”时，优先用本技能自动创建/更新任务，
+  并通过 /tasks、/run <task> 与手机端协同。
+---
+
+# Heartbeat Task Manager
+
+用于 MetaMe Desktop Daemon 的心跳任务管理。
+
+## 适用场景
+
+- 用户说“每天提醒我…”
+- 用户说“6点提醒我…”
+- 用户要查看已有任务
+- 用户要让后台立即执行某个任务
+
+## 强约束
+
+1. 仅操作 `~/.metame-desktop/config-desktop.yaml` 对应的 Desktop 任务域。
+2. 不操作外部项目 daemon，不执行全局进程控制。
+3. 优先使用 CLI 子命令，不手改 YAML 文本。
+
+## 推荐流程
+
+### 1) 新增/更新提醒任务
+
+当用户给出提醒语句时，执行：
+
+```bash
+metame daemon --sub add-task --text "<用户原话>"
+```
+
+示例：
+
+```bash
+metame daemon --sub add-task --text "每天6点提醒我喝水"
+metame daemon --sub add-task --text "每天提醒我复盘今天进展"
+```
+
+### 2) 查看任务列表
+
+```bash
+metame daemon --sub tasks
+```
+
+### 3) 手机端联动提示
+
+创建成功后，告诉用户：
+
+- 手机可发送 `/tasks` 查看列表
+- 手机可发送 `/run <task>` 立即执行
+
+## 回复模板（简短）
+
+- 成功：
+  - 已帮你设置提醒任务。
+  - 你可以在手机输入 `/tasks` 查看，或 `/run <task>` 立即执行。
+- 失败（语义不匹配）：
+  - 我没识别到提醒语义，请改成“每天提醒我…”或“每天6点提醒我…”。
+

package/skills/macos-local-orchestrator/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: macos-local-orchestrator
+description: |
+  macOS 本地自动化编排与能力融合。通过 Bash + osascript/JXA + Shortcuts + launchd
+  实现自然语言电脑管家，并在需要时编排 Hammerspoon、AeroSpace、yabai/skhd、
+  Raycast Script Commands、Keyboard Maestro 等第三方工具。适用于应用控制、系统控制、
+  权限引导、窗口管理、快捷操作、定时任务与桌面自动化场景。
+---
+
+# macOS Local Orchestrator
+
+Use local deterministic automation on macOS with minimal token usage.
+
+## Execution Policy
+
+1. Prefer local deterministic tools first: `Bash` + `osascript`/JXA.
+2. Prefer built-in macOS capabilities before third-party tools.
+3. Avoid screenshot/visual workflows unless user explicitly asks for them.
+4. Classify every request before execution:
+   - Read/query action: execute directly.
+   - Side-effect action: show a short preview and ask for explicit confirmation first.
+5. Keep output short: success/failure + key result only.
+
+## Capability Ladder
+
+### L0 Native (default)
+
+Use these first because they are stable and dependency-free:
+- `osascript` AppleScript/JXA for app/system control
+- `open` and `x-apple.systempreferences:` for settings navigation
+- `shortcuts` CLI for reusable workflows
+- `launchctl` + `~/Library/LaunchAgents` for scheduled/background jobs
+- `pmset` for power scheduling
+
+### L1 Optional Integrations (when user already has them)
+
+Detect tool availability and then use:
+- `AeroSpace` for tiling/workspace (SIP-friendly, CLI-first)
+- `yabai` + `skhd` for advanced window + hotkey control
+- `Hammerspoon` for event-driven automation (`~/.hammerspoon/init.lua`)
+- `Raycast` Script Commands / Deeplinks for launcher workflows
+- `Keyboard Maestro` CLI trigger for mature macro pipelines
+
+Do not force-install tools automatically unless user explicitly requests installation.
+
+## Tool Selection Rules
+
+1. If user asks app open/quit, volume, lock/sleep, permissions: use `osascript` first.
+2. If user asks reusable multi-step workflow: prefer `shortcuts run`.
+3. If user asks scheduled recurring action: prefer `launchd` or `pmset`.
+4. If user asks keyboard-first window tiling:
+   - Prefer `AeroSpace` if installed.
+   - Else use `yabai/skhd` if installed.
+   - Else fallback to native scripting and explain capability limits.
+5. If user asks event-driven desktop reactions (wifi change, battery alerts, app watcher): use `Hammerspoon` if installed.
+6. If user already uses Raycast/Keyboard Maestro ecosystem, integrate by calling their commands instead of rebuilding features.
+
+For ecosystem-level tool tradeoffs and install decisions, read:
+`references/tooling-landscape.md`
+
+## Side-Effect Confirmation Rules
+
+Require confirmation before any action that changes state, including:
+- Sending email, creating/deleting/modifying calendar events
+- Quitting apps, system sleep, lock screen
+- Writing/moving/deleting files or folders
+- Any command with unclear scope or risk
+
+Use this confirmation template:
+- `准备执行：<one-line action>`
+- `命令：<exact command>`
+- `请回复“确认执行”后继续。`
+
+## Native Command Patterns
+
+Open app:
+
+```bash
+osascript -e 'tell application "WeChat" to activate'
+```
+
+Quit app:
+
+```bash
+osascript -e 'tell application "WeChat" to quit'
+```
+
+Set volume:
+
+```bash
+osascript -e 'set volume output volume 35'
+```
+
+Mute / unmute:
+
+```bash
+osascript -e 'set volume with output muted'
+osascript -e 'set volume without output muted'
+```
+
+Lock screen:
+
+```bash
+osascript -e 'tell application "System Events" to keystroke "q" using {control down, command down}'
+```
+
+Sleep:
+
+```bash
+osascript -e 'tell application "System Events" to sleep'
+```
+
+Open permissions/settings:
+
+```bash
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_Automation"
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture"
+```
+
+Run shortcut:
+
+```bash
+shortcuts list
+shortcuts run "My Shortcut"
+shortcuts run "My Shortcut" -i ~/Desktop/input.txt -o ~/Desktop/output.txt
+```
+
+Create/refresh LaunchAgent job:
+
+```bash
+launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.metame.task.plist 2>/dev/null || true
+launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.metame.task.plist
+launchctl print gui/$(id -u)/com.metame.task
+```
+
+Power schedule:
+
+```bash
+pmset -g sched
+sudo pmset repeat wake M 08:00:00
+sudo pmset repeat cancel
+```
+
+## Optional Tool Patterns
+
+AeroSpace (if installed):
+
+```bash
+aerospace list-workspaces --all
+aerospace focus-workspace 2
+aerospace move-node-to-workspace 2
+```
+
+yabai/skhd (if installed):
+
+```bash
+yabai -m query --windows --window
+yabai -m window --focus east
+skhd --reload
+```
+
+Keyboard Maestro CLI (if installed):
+
+```bash
+ls "/Applications/Keyboard Maestro.app/Contents/MacOS" 2>/dev/null
+```
+
+## Error Handling
+
+1. If command output is empty for successful action, report as `已执行` (not `no output`).
+2. If permission is missing, explain which permission is required and guide user to open the corresponding settings page, then retry.
+3. If app name is ambiguous, ask a clarification question before executing.
+4. If requested third-party tool is missing, provide:
+   - current state (`未检测到 <tool>`)
+   - minimal install command (only when user asks to install)
+   - immediate native fallback plan.
+
+## Permission Checklist
+
+- Automation: Privacy & Security -> Automation
+- Accessibility: Privacy & Security -> Accessibility
+- Screen & System Audio Recording (only if screen pipeline is explicitly needed)
+- Full Disk Access (only for file-heavy operations)
+
+Permission onboarding commands:
+
+```bash
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_Automation"
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"
+open "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture"
+```

package/skills/macos-local-orchestrator/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "macOS Local Orchestrator"
+  short_description: "Use local Bash/AppleScript to automate Mac tasks safely"
+  default_prompt: "Use this skill to automate macOS with local scripts and confirmation for side effects."

package/skills/macos-local-orchestrator/references/tooling-landscape.md

@@ -0,0 +1,70 @@
+# macOS Automation Tooling Landscape (Fusion Notes)
+
+## Goal
+
+Map mature macOS automation ecosystems into one orchestration skill, with a native-first strategy.
+
+## Native Foundation (Always Available)
+
+1. AppleScript / JXA via `osascript`
+   - Use for app control, system actions, and cross-app scripting.
+2. Shortcuts CLI (`shortcuts`)
+   - Use for reusable multi-step workflows and parameterized runs.
+3. `launchd` / `launchctl`
+   - Use for resilient user-level background tasks (`~/Library/LaunchAgents`).
+4. `pmset`
+   - Use for wake/sleep scheduling.
+5. System Settings deep links (`x-apple.systempreferences:`)
+   - Use for permission onboarding and recovery.
+
+## Third-Party Integrations (Optional)
+
+1. Hammerspoon
+   - Best for event-driven automation and custom hotkey/event hooks.
+   - Needs Accessibility permissions.
+2. AeroSpace
+   - Best for keyboard-first tiling workspace management.
+   - CLI-oriented and SIP-friendly.
+3. yabai + skhd
+   - Best for advanced window tree manipulation + hotkey daemon.
+   - Powerful but setup can be more complex than native/AeroSpace.
+4. Raycast Script Commands
+   - Best for launcher-style command catalog and human-triggered flows.
+5. Keyboard Maestro
+   - Best for mature macro workflows in GUI-heavy productivity use cases.
+
+## Fusion Strategy
+
+1. Keep one unified intent layer in `macos-local-orchestrator`.
+2. Apply runtime detection:
+   - If requested tool exists, use it.
+   - If missing, fallback to native path and report gap briefly.
+3. Keep confirmation gate for all side effects.
+4. Prefer native fallback before introducing new dependencies.
+
+## Source Links
+
+- Apple: Mac Automation Scripting Guide  
+  https://developer.apple.com/library/archive/documentation/LanguagesUtilities/Conceptual/MacAutomationScriptingGuide/
+- Apple: `shortcuts` command-line docs  
+  https://support.apple.com/guide/shortcuts-mac/command-line-interface-apd455c82f02/mac
+- Apple: Launch daemons and agents  
+  https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html
+- Apple: `pmset` usage  
+  https://support.apple.com/en-sa/guide/mac-help/mchl40376151/mac
+- Apple: Allow apps to control your Mac (Automation permission)  
+  https://support.apple.com/en-vn/guide/mac-help/mchl108e1718/mac
+- Apple: Allow accessibility apps to access your Mac  
+  https://support.apple.com/en-kz/guide/mac-help/mh43185/mac
+- Hammerspoon docs  
+  https://www.hammerspoon.org/docs/
+- AeroSpace repo/docs  
+  https://github.com/nikitabobko/AeroSpace
+- yabai repo/docs  
+  https://github.com/koekeishiya/yabai
+- skhd repo/docs  
+  https://github.com/koekeishiya/skhd
+- Raycast Script Commands  
+  https://developers.raycast.com/information/lifecycle/script-commands
+- Keyboard Maestro docs  
+  https://wiki.keyboardmaestro.com