用途:通过 gh 命令对由模板生成的新仓库进行 GitHub 端的初始设置,使 Actions secrets、PR 创建权限、auto-merge 与默认分支保护保持一致。所有操作以 REPO=<owner>/<name> 为目标,重复执行相同值不会改变结果。
主要能力与步骤:一是修改 apps/web/app-name.ts 中的 APP_NAME,使其与仓库名一致,避免同一 Cloudflare 账户下不同仓库资源名冲突。二是注册 secrets,值需向用户询问:gh secret set OPENROUTER_API_KEY、CLAUDE_CODE_OAUTH_TOKEN、CLOUDFLARE_ACCOUNT_ID、CLOUDFLARE_API_TOKEN,均带 --repo "$REPO"。其中 OPENROUTER_API_KEY 供 verify 工作流的 oxlint-plugin-decision 使用,CLAUDE_CODE_OAUTH_TOKEN 用于 verify 失败时由 Claude Code 自动修正,后两者用于部署与 Alchemy 状态。若为 Organization 仓库,可在 Organization secrets 中注册一次。
三是允许 Actions 创建 PR:调用 gh api --method PUT "repos/$REPO/actions/permissions/workflow",设 default_workflow_permissions=read、can_approve_pull_request_reviews=true,供 release-please 与自动修正使用。四是限制 PR 创建者为 collaborator 并启用 auto-merge:gh api --method PATCH "repos/$REPO",设 pull_request_creation_policy=collaborators_only、allow_auto_merge=true、allow_update_branch=true。五是设置默认分支规则集:禁止删除与 force push,要求 PR 合并前包含最新默认分支,检查通过 up-to-date 工作流与 strict_required_status_checks_policy 实现,不设 bypass;同名规则集存在时替换。
限制:资料未提供官方文档说明、安装命令、费用、支持平台或适用范围等信息;未提及除上述命令外的用法。