这个包把“前端代码发布到 Cloudflare Pages 生成预览链接”的流程封装成可分发给同事的 AI 工具包。

它既支持 Codex / Claude Code 的 skill 目录，也提供通用提示词和多种 AI 工具可读取的说明文件，方便在 Cursor、Windsurf、Cline、Continue、ChatGPT、Gemini、自研 Agent 等环境里复用。

复制 skill 目录到本机 skill 池：

mkdir -p ~/.codex/skills
cp -R cf-pages-preview ~/.codex/skills/

如果同事使用 Claude Code，也可以复制到：

mkdir -p ~/.claude/skills
cp -R cf-pages-preview ~/.claude/skills/

安装后建议重启 Codex / Claude Code / 相关 IDE，让 skill 路由重新加载。

如果同事不用 Codex / Claude Code，直接打开：

• PROMPT.md：复制整段提示词给任意 AI。
• AGENTS.md：放到项目根目录，供支持 Agent 指令的工具读取。
• CLAUDE.md：放到项目根目录，供 Claude Code 读取。
• GEMINI.md：放到项目根目录，供 Gemini 或其他工具读取。
• .cursor/rules/cf-pages-preview.mdc：放到 Cursor 项目中。
• .windsurfrules：放到 Windsurf 项目根目录。
• .clinerules：放到 Cline 项目根目录。
• .github/copilot-instructions.md：放到 GitHub Copilot 项目中。
• .trae/project_rules.md 或 .trae/rules/project_rules.md：放到 Trae 项目中。不同 Trae 版本和资料使用过两个路径，本包两个都提供。
• opencode.json + AGENTS.md：放到 OpenCode 项目根目录。OpenCode 会读取 AGENTS.md，也可通过 opencode.json 的 instructions 字段加载详细文件。

对 AI 说类似：

• “把这个前端 demo 部署到 CF Pages，给我预览链接”
• “发给同事看，生成一个 Cloudflare Pages 页面”
• “这个活动页做完了，推到 CF Pages”

AI 应该会先检查构建和敏感信息，再部署到 Cloudflare Pages，并返回预览地址。

• 本机已安装 Node.js。
• 可使用 wrangler 或 npx wrangler。
• Cloudflare 账号已经登录，并有 Pages 项目部署权限。

如果没有 Cloudflare 账号：

• Cloudflare Pages 部署需要账号。
• 可以从 Cloudflare Free plan 开始注册。
• 注册/登录/授权失败时，让已有账号和可用网络的同事部署，或改用其他预览平台。

不要承诺 Cloudflare Dashboard、Wrangler 授权页、API、.pages.dev 预览链接在所有网络都稳定可用。中国大陆、企业代理、DNS、运营商线路或 Cloudflare 风控都可能导致访问失败。

遇到问题时先诊断：

curl -I https://dash.cloudflare.com
curl -I https://pages.cloudflare.com
curl -I https://api.cloudflare.com/client/v4/user/tokens/verify

如果目标评审用户打不开 .pages.dev，建议改用公司内网静态服务、国内云厂商静态托管/CDN、对象存储静态网站，或由有可用网络的同事代部署。

• cf-pages-preview/SKILL.md：skill 主说明。
• cf-pages-preview/scripts/cf-pages-preflight.sh：本地预检脚本。
• cf-pages-preview/references/cloudflare-account-network.md：账号和网络问题说明。
• cf-pages-preview/agents/openai.yaml：Codex app 展示元信息。
• PROMPT.md：适合任意 AI 工具的通用提示词。
• AGENTS.md / CLAUDE.md / GEMINI.md：不同工具的兼容入口。
• .cursor/rules/、.windsurfrules、.clinerules、.github/copilot-instructions.md：常见 AI 编程工具兼容规则。
• .trae/project_rules.md、.trae/rules/project_rules.md：Trae 兼容规则。
• opencode.json、.opencode/instructions/cf-pages-preview.md：OpenCode 兼容入口。