为什么值得关注

该技能通过结合官方文档、本地类型定义和实时设备同步，为构建复杂的 iOS 自动化项目（Scripting App）提供了结构化且对代理友好的方法。

适合谁使用

桌面编码代理用户（如 Codex、Claude Code）
构建 Scripting App 项目（TypeScript、Widget、Live Activities）的开发者
iOS 自动化爱好者
代理辅助应用开发实践者

典型使用场景

自动化创建 Scripting App 脚本和小部件
通过实时设备检查调试和验证 Scripting App 项目
通过编码代理开发 iOS 风格页面、意图和 Safari 脚本
使用 scripting-cli 集成桌面到 iPhone 的工作流

项目优势

为每种任务类型提供聚焦的参考、模板和检查清单
确保代理使用官方 LLM 文档和本地 .d.ts 文件来获取准确签名
支持 Scripting App 的广泛特性（Widget、Live Activities、意图）
包含开发循环和真实设备验证，提高可靠性

使用前须知

需要桌面编码代理环境（Codex、Claude Code）和 Node.js 20+
仅限于 Scripting App 项目，非通用开发技能
依赖官方文档和同步的类型定义，可能存在版本差异

README 快速开始

Scripting App Development Skill

A development skill for desktop coding agents such as Codex and Claude Code. It helps agents create, modify, debug, and validate Scripting App projects: TypeScript/TSX scripts, iOS-style pages, native APIs, Widgets, Live Activities, rich notifications, Shortcuts/Share Sheet intents, App Intents, and Safari browser scripts.

Install

Copy or link this repository into the skill directory used by your coding agent. The root SKILL.md is the entry point; it loads only the relevant files under references/, templates/, and checklists/ for each task.

Documentation and local typings

Before writing Scripting-specific code, the skill requires the agent to consult the official LLM documentation index:

For desktop-to-iPhone development, use scripting-cli:

# Requires Node.js 20+
npx scripting-cli start

After the Scripting App connects to the initialized workspace, it synchronizes current .d.ts declarations. The agent should use them to verify exact local TypeScript signatures, imports/globals, event payloads, and TSX props, while using the official documentation for behavioral, permission, and host constraints.

SKILL.md                         Main routing, API lookup, validation, and safety rules
references/                      Focused guides for project lifecycle, UI, native APIs,
                                 Widgets/App Intents, Live Activities, notifications/Intents,
                                 Safari scripts, desktop CLI, and validation/security
templates/                       Minimal `script.json`, entry-point, Widget, Intent, and userscript starters
checklists/                      Project creation, modification, desktop live-debug, and host E2E checks

Development loop

Identify the target Scripting host and entry point.
Query llms.txt and the exact official API/capability page.
When available, initialize scripting-cli, connect the app, and inspect synced .d.ts files for the connected app version.
Implement the smallest compatible change.
Run diagnostics, CLI/live-sync checks, and applicable previews.
Complete the required real device-host verification for Widgets, Live Activities, notifications, Intents, and Safari scripts.

Scope

项目描述

A development skill for desktop coding agents to build, debug, and validate Scripting App projects.

scripting-app-development