AgentSkillsCN

notify

向用户发送 macOS 通知以示提醒。适用于任务完成、实习生结束工作、有事项亟待处理，或在被明确要求通知时使用。实习生在完成重要工作时，应优先使用此功能。

SKILL.md
--- frontmatter
name: notify
description: Send a macOS notification to alert the user. Use when a task is complete, an intern finishes work, something needs attention, or when explicitly asked to notify. Interns should use this when they finish significant work.

Notify

Send a macOS desktop notification that stays on screen until dismissed.

Usage

Use terminal-notifier to send a sticky alert:

bash
terminal-notifier -title "TITLE" -message "MESSAGE" -sound Glass -type alert

Replace MESSAGE with a brief description of what happened, and TITLE with a short label.

Fallback — if terminal-notifier is not available, use osascript (auto-dismisses):

bash
osascript -e 'display notification "MESSAGE" with title "TITLE" sound name "Glass"'

Examples

Task complete:

bash
terminal-notifier -title "Squad: gateway-core done" -message "Gateway UI build finished — 4 commits on gateway-abstraction" -sound Glass -type alert

Needs attention:

bash
terminal-notifier -title "Squad: review ready" -message "PR #7126 review found 2 critical issues" -sound Glass -type alert

Error/stuck:

bash
terminal-notifier -title "Squad: gateway-core stuck" -message "Build failed — missing dependency in Cargo.toml" -sound Glass -type alert

Guidelines

  • •Title: Keep short. Use format Squad: <intern-name> <status> (e.g., Squad: gateway-core done)
  • •Message: One line, include key details (what finished, what's needed, commit count, etc.)
  • •Sound: Always use Glass for consistency
  • •Type: Always use alert so it stays on screen until dismissed
  • •When to notify:
    • •Task/intern finished significant work
    • •Something needs user attention
    • •Error or blocker encountered
    • •When explicitly asked to notify
  • •Don't spam: One notification per completed task, not per commit