用途:该技能面向使用 Raycast API 开发与维护 Raycast 扩展的场景,基于 React 与 TypeScript。
主要能力与约定:提供组件选型与实现指引,包括 List、Grid、Detail、Form 等 UI 组件,以及 ActionPanel、Action.Push、Action.CopyToClipboard、Action.SubmitForm 等交互动作。反馈方面建议用 showToast 处理 Loading/Success/Failure,showHUD 仅用于快速后台完成提示。数据方面用 Cache 存频繁或临时数据,用 LocalStorage 存持久用户数据。受限 API 如 AI 与 BrowserExtension 需先用 environment.canAccess 检查后再调用。
使用方式:先确定核心组件类型(List、Grid、Detail 或 Form),再查阅 references/api/ 下对应文件(如 references/api/list.md),按默认约定实现,并在引用时链接回所用的参考文件。Form 必须包含 SubmitForm 动作。
仓库约定:更新 Raycast 扩展仓库的 CHANGELOG.md 时,日期占位符一律使用 {PR_MERGE_DATE},不得写入具体日历日期。
适用场景:实现或修复 Raycast 功能、构建可搜索列表与网格界面、展示富 Markdown 详情、收集用户输入、调用 AI 与浏览器扩展能力等。
限制:AI 与 BrowserExtension 属受限 API,必须通过 environment.canAccess 判断可用性;资料未提供具体收费、价格、平台支持范围或效果数据。