关于 notion-apps
notion-apps 是使用 Notion CLI 和 SDK 构建 Notion Apps 的技能,指导 Agent 先确认 Alpha 资格,再创建项目并遵循生成项目中的开发指南。
主要功能
- 01开始前确认 Alpha 资格
- 02检查并安装 Notion CLI
- 03创建含依赖和 Git 的项目
- 04阅读生成的 AGENTS.md 指南
适用场景
- 01开始 App 项目前确认资格
- 02创建新的 Notion App 项目
- 03依据项目专属指南继续实现
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ makenotion/ skills --skill notion-apps安装后在 Claude Code 中输入/notion-apps确认已加载。
附带文件agents/openai.yaml
详细介绍
Notion Apps
确认 Alpha 访问权限
在运行命令或检查 App 项目之前,请先询问用户是否已获准参与 Notion Apps Alpha。CLI 身份验证、已启用 CLI 实验功能或本地可运行的 SDK,都不能证明用户拥有 Alpha 访问权限。如果用户回答否或无法确认,请说明 SDK 代码可能可以在本地构建,但部署需要 Alpha 访问权限,然后停止 App 工作流。
设置和搭建项目
确认拥有 Alpha 访问权限后,使用 ntn --version 检查是否已安装 Notion CLI。如果尚未安装,请使用适用于用户平台的命令进行安装:
# macOS and Linux
curl -fsSL https://ntn.dev | bash
# Windows
winget install Notion.ntn
搭建一个安装好依赖并已初始化 Git 的全新 App 项目:
ntn apps new --install --git <app-directory>
始终指定明确的目标目录。Agent 无法使用 CLI 的交互式目录提示。如果当前目录为空且适合作为项目根目录,请使用 .;否则,请根据用户的请求或上下文推断合适的目录。如果无法安全推断目标目录,请在搭建项目前询问项目应放在哪里。如果 apps 命令不可用,请使用 ntn experiments enable apps 启用它,然后重试。
项目创建完成后,请在项目根目录中工作,并完整阅读其中的 AGENTS.md。该文件包含为生成的项目提供的 App 设计、实现、功能能力和部署指导。后续任务请遵循该文件以及已安装 SDK 的特定版本指南。
评论
支持 Markdown