mail_draft

01 前言 Front Matter

args

[ "{{subject}}", "{{body}}", "{{attachment}}", "{{to}}" ]

name

mail_draft

schema

{ "to": { "type": "string", "default": "", "required": false, "description": "Recipient email address (optional — drafts can have empty to)" }, "body": { "type": "string", "default": "", "required": false, "description": "Plain-text body of the email" }, "subject": { "type": "string", "required": true, "description": "Email subject line (required)" }, "attachment": { "type": "string", "default": "", "required": false, "description": "Absolute POSIX path to a file to attach (optional)" } }

command

[ "sh", "-c", "SUBJECT=\"$1\"; BODY=\"$2\"; ATTACH=\"$3\"; TO=\"$4\"\n[ -z \"$SUBJECT\" ] && { echo \"subject required\" >&2; exit 1; }\n\n# Escape backslashes and double-quotes for AppleScript string literals.\nesc() { printf '%s' \"$1\" | /usr/bin/sed -e 's/\\\\/\\\\\\\\/g' -e 's/\"/\\\\\"/g'; }\nSUBJECT_E=\"$(esc \"$SUBJECT\")\"\nBODY_E=\"$(esc \"$BODY\")\"\nTO_E=\"$(esc \"$TO\")\"\n# ATTACH is a path — leave it as-is for POSIX file coercion\n\nosascript 2>&1 <<APPLE\ntell application \"Mail\"\n set newMsg to make new outgoing message with properties ¬\n {subject:\"$SUBJECT_E\", content:\"$BODY_E\", visible:false}\n if \"$TO_E\" is not \"\" then\n try\n tell newMsg to make new to recipient at end of to recipients ¬\n with properties {address:\"$TO_E\"}\n end try\n end if\n if \"$ATTACH\" is not \"\" then\n try\n tell newMsg to make new attachment ¬\n with properties {file name:(POSIX file \"$ATTACH\")}\n on error errMsg\n save newMsg\n return \"draft_saved_no_attach: \" & errMsg\n end try\n end if\n save newMsg\n return \"draft_saved\"\nend tell\nAPPLE\n", "_" ]

timeout

30

description

Create a Mail draft (saved, not sent) with subject + body and an optional attachment. Uses Mail's AppleScript dictionary directly: `make new outgoing message` then `save` (NOT `send`). The draft appears in the Drafts mailbox of the default account. This is the CORRECT path for any task that says "save as Mail draft" / "share via Mail as draft". Common wrong path: agents open a compose window with Cmd+N, type subject + body, then close with Cmd+W — that prompts a Save sheet they often skip, losing the draft. This skill bypasses the compose window entirely.

03 SKILL.md 正文

mail_draft subject="KinBench Share 167" body="forwarding the note"
  → draft_saved

mail_draft subject="KinBench 369" body="see attached" attachment="/Users/me/Desktop/kinbench/369-note.pdf"
  → draft_saved