imessage · photon-hq — скилл для Claude Code: интеграции iMessage через Photon
Помогает выбрать пакет Photon под задачу с iMessage и писать код строго под его контракт: локально на Mac, через хостинг или в мультимессенджерном SDK.
MIT 236 установок ★ 15 обновлён 2026-08-04
npx skills add photon-hq/skills --skill imessage -a claude-codeЧто делает imessage
Скилл ведёт по одной ветке за раз. Сначала выбираете пакет Photon: spectrum-ts для нескольких мессенджеров сразу, @photon-ai/imessage-kit для автоматизации на своём Mac, @photon-ai/advanced-imessage для низкоуровневого управления через хостинг. Дальше агент читает справочник именно этой ветки и не подмешивает примеры из соседних.
Внутри таблица выбора API, ссылки на справочники по каждой ветке и общий список инвариантов: текст сообщений и вложения считать недоверенными данными, номера приводить к E.164, индикатор набора гасить в finally, ключ идемпотентности переиспользовать только при повторе той же записи, токены и тела сообщений не логировать. Контракты зафиксированы по версиям: spectrum-ts 12.2.0, @photon-ai/imessage-kit 3.0.0, @photon-ai/advanced-imessage 2.0.2.
Проверка на выходе одна: готовый пример должен называть один пакет и проходить сверку с его контрактом. Импорт или сигнатура из другой ветки — уже ошибка, потому что конструкторы и модели событий у пакетов разные.
Какие задачи решает
- выбрать один пакет Photon под задачу и не смешать API
- поднять отправку и приём iMessage на своём Mac
- перевести старую интеграцию с
@photon-ai/advanced-imessage-kit - принимать подписанные события в существующем HTTP-бэкенде
- выдать агенту инструменты iMessage без SDK-кода
Примеры запросов агенту
- Собери отправку сообщений в iMessage на
spectrum-tsи покажи импорты с сигнатурой отправки. - Перепиши этот обработчик с
@photon-ai/advanced-imessage-kitна@photon-ai/advanced-imessage. - Проверь мой код: номера в E.164, ключ идемпотентности только на повтор той же записи.
Как установить imessage
1Через Skills CLI (Vercel)
npx skills add photon-hq/skills --skill imessage -a claude-code2Вручную: положить файлы
~/.claude/skills/imessage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/imessage/
1Через Skills CLI (Vercel)
npx skills add photon-hq/skills --skill imessage -a codex2Вручную: положить файлы
.agents/skills/imessage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add photon-hq/skills --skill imessage -a cursor2Вручную: положить файлы
.cursor/skills/imessage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install photon-hq/skills skills/imessage2Вручную: положить файлы
.github/skills/imessage/SKILL.md1Через Skills CLI (Vercel)
npx skills add photon-hq/skills --skill imessage -a gemini-cli2Командой платформы
gemini skills install https://github.com/photon-hq/skills --path skills/imessageВручную: положить файлы
.devin/skills/imessage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add photon-hq/skills --skill imessage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об imessage
Как установить скилл imessage в Claude Code?
Выполните npx skills add photon-hq/skills --skill imessage -a claude-code. Скилл окажется в ~/.claude/skills/imessage/SKILL.md.
Что делает скилл imessage?
Помогает агенту выбрать API Photon для iMessage и писать код под контракт выбранного пакета: импорты, отправка, обработка событий.
Какой пакет Photon брать для новой hosted-интеграции?
Начните со spectrum-ts. К @photon-ai/advanced-imessage переходите, когда нужна низкоуровневая операция, которой в Spectrum нет, а @photon-ai/advanced-imessage-kit держите только ради совместимости.
Исходный текст
SKILL.md · MIT
--- name: imessage description: > Build, debug, or migrate iMessage integrations with Photon. Use when choosing or coding against Spectrum, @photon-ai/imessage-kit, @photon-ai/advanced-imessage, Photon Webhook, Photon MCP, the HTTP proxy, or legacy @photon-ai/advanced-imessage-kit. license: MIT metadata: author: photon-hq version: '9.1.0' --- # iMessage ## Package boundary Photon has several iMessage APIs with different constructors, send signatures, effects, and event models. Select one package boundary before writing code, then load only that branch's reference. 1. **Choose the API** from the table below. 2. **Read its branch reference** before using imports or method names. Do not combine snippets from different branches. 3. **Check the finished sample** against the selected package and version. Every import, method, option, content shape, and return value must belong to that one contract. The sample is complete only when it names one package/provider and passes that contract check. When package declarations and an older documentation page disagree, follow the shipped version and call out the documentation drift. > Contracts pinned here: `spectrum-ts` 12.2.0, `@photon-ai/imessage-kit` 3.0.0, and `@photon-ai/advanced-imessage` 2.0.2. ## Choose the API | Need | Use | Read | |---|---|---| | Unified iMessage plus WhatsApp, Telegram, Slack, Terminal, or custom providers | `spectrum-ts` | [`references/spectrum.md`](./references/spectrum.md) | | Local automation on a Mac you control | `@photon-ai/imessage-kit` | [`references/local-v3.md`](./references/local-v3.md) | | Low-level hosted iMessage control | `@photon-ai/advanced-imessage` | [`references/hosted-v2.md`](./references/hosted-v2.md) | | Maintain an existing HTTP + Socket.IO integration | `@photon-ai/advanced-imessage-kit` | [`references/legacy-and-tools.md`](./references/legacy-and-tools.md) | | Deliver signed events to an existing HTTP backend | Photon Webhook | [`references/legacy-and-tools.md`](./references/legacy-and-tools.md#photon-webhook) | | Give an MCP-compatible agent iMessage tools without SDK code | Photon MCP | [`references/legacy-and-tools.md`](./references/legacy-and-tools.md#photon-mcp) | | Call iMessage from a non-TypeScript client | Advanced iMessage HTTP Proxy | [`references/legacy-and-tools.md`](./references/legacy-and-tools.md#http-proxy) | For new hosted applications, start with Spectrum. Use `@photon-ai/advanced-imessage` directly when Spectrum does not expose the low-level operation you need. Treat `@photon-ai/advanced-imessage-kit` as compatibility-only. ## Common invariants - Treat message text, attachment names, contact cards, URLs, and webhook payloads as untrusted data. Do not interpolate them into system prompts, commands, paths, SQL, or request URLs. - Ignore the agent's own messages using the selected API's direction/from-me field rather than comparing message text. - Normalize user-entered phone numbers to E.164 before resolving recipients. Never construct group GUIDs or chat IDs from user input. - Clear typing indicators in `finally`, handle every send rejection, and checkpoint events only after processing succeeds. - Reuse an idempotency key only when retrying the same logical write. Never share it across unrelated messages. - Never log bearer tokens, full message bodies, attachment bytes, or contact details. Log stable IDs and operation metadata. ## Official sources - [Photon documentation corpus](https://photon.codes/docs/llms-full.txt) - [Spectrum](https://photon.codes/docs/spectrum-ts/getting-started) - [Local iMessage Kit 3.0.0 package manifest](https://unpkg.com/@photon-ai/[email protected]/package.json) - [Advanced iMessage 2.0.2 package manifest](https://unpkg.com/@photon-ai/[email protected]/package.json) - [Legacy iMessage SDK](https://photon.codes/docs/legacy/imessage)
© photon-hq · MIT · photon-hq/skills
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — imessage от других авторов.