mcpField
N
notion-apps

notion-apps

github.com/makenotion开发177341 次安装5 周前更新
代码仓库

关于 notion-apps

notion-apps 是使用 Notion CLI 和 SDK 构建 Notion Apps 的技能,指导 Agent 先确认 Alpha 资格,再创建项目并遵循生成项目中的开发指南。

主要功能

  1. 01开始前确认 Alpha 资格
  2. 02检查并安装 Notion CLI
  3. 03创建含依赖和 Git 的项目
  4. 04阅读生成的 AGENTS.md 指南

适用场景

  1. 01开始 App 项目前确认资格
  2. 02创建新的 Notion App 项目
  3. 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