PROTO NOTE DEVELOPER TOOLS

安装 ProtoNote Prototype Skill

把 ProtoNote 的原型规范、批注规则和提交流程接入 Codex。安装后，在任意 Codex 工作区调用 @ProtoNote Prototype Skill 即可开始。

当前版本 0.2.1Node.js >=22.13.0支持 Windows / macOS / Linux

AI Agent 安装指南（纯文本，包含 CLI 和 Skill 完整步骤） · Agent 入口

先安装 CLI，再安装 SkillSkill 负责工作流规则，CLI 负责本机文件同步和线上提交，两者需要配合使用。

确认 CLI 已安装

如果还没有安装命令行工具，请先完成 CLI 安装。在终端确认：

node --version
protonote.cmd --version

下载并安装 Skill

Skill 包不包含账号凭据，只包含工作流说明和 Codex 元数据。请选择对应系统执行：

$ErrorActionPreference = "Stop"
$zip = Join-Path $env:TEMP "protonote-prototype-skill-0.2.1.zip"
Invoke-WebRequest -Uri "https://789779.xyz/downloads/protonote-prototype-skill-0.2.1.zip" -OutFile $zip
if ((Get-FileHash -Algorithm SHA256 -LiteralPath $zip).Hash -ne "12eb8e93652259224f9d514bdeb98e772c2343665d7c249d9ab3cf8867a8688c") { throw "Skill SHA-256 校验失败" }
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }
$skillRoot = Join-Path $codexHome "skills"
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
$installedSkill = Join-Path $skillRoot "protonote-prototype"
if (Test-Path -LiteralPath $installedSkill) { Copy-Item -LiteralPath $installedSkill -Destination "$installedSkill.backup-$([Guid]::NewGuid().ToString('N'))" -Recurse }
Expand-Archive -Path $zip -DestinationPath $skillRoot -Force

set -eu
skill_root="${CODEX_HOME:-$HOME/.codex}/skills"
mkdir -p "$skill_root"
curl --fail --location "https://789779.xyz/downloads/protonote-prototype-skill-0.2.1.zip" --output "/tmp/protonote-prototype-skill-0.2.1.zip"
if command -v sha256sum >/dev/null 2>&1; then actual=$(sha256sum "/tmp/protonote-prototype-skill-0.2.1.zip"); else actual=$(shasum -a 256 "/tmp/protonote-prototype-skill-0.2.1.zip"); fi
[ "${actual%% *}" = "12eb8e93652259224f9d514bdeb98e772c2343665d7c249d9ab3cf8867a8688c" ] || { echo "Skill SHA-256 校验失败" >&2; exit 1; }
if [ -d "$skill_root/protonote-prototype" ]; then
  backup_dir=$(mktemp -d "$skill_root/protonote-prototype.backup.XXXXXX")
  cp -R "$skill_root/protonote-prototype" "$backup_dir/"
fi
unzip -qo "/tmp/protonote-prototype-skill-0.2.1.zip" -d "$skill_root"

直接下载 Skill 0.2.1

在 Codex 中启用

重新打开 Codex 或刷新当前工作区，然后发送：

@ProtoNote Prototype Skill

请检查当前工作区是否已启用 ProtoNote，并准备开始工作。

Skill 第一次接管工作区时，会创建当前工作区的启用标记。不同项目需要分别启用，不会自动读取其他工作区。

完成一次工作区检查

仅在用户于目标工作区显式调用 @ProtoNote Prototype Skill 后执行启用。安装本身不会自动启用工作区；需要手动排查时，在该目标目录执行：

protonote.cmd agent enable --dir .
protonote.cmd auth status

NEXT STEP

开始处理线上原型

CLI 和 Skill 都安装好后，就可以让 Codex 按 ProtoNote 的规范准备、校验并提交原型版本。

返回 ProtoNote