metame-cli 1.5.10 → 1.5.12

package/skills/find-skills/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Search for Skills
+
+Run the find command with a relevant query:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+The command will return results like:
+
+```
+Install with npx skills add <owner/repo@skill>
+
+vercel-labs/agent-skills@vercel-react-best-practices
+└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 3: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install command they can run
+3. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "vercel-react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+
+To install it:
+npx skills add vercel-labs/agent-skills@vercel-react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 4: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```

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