boring-new-app

用途：为 Boring Factory 端到端创建一个新应用仓库，最终得到一个专家可直接开始开发功能、由 Factory 接手后续流程的仓库。作者是维护者（Factory 所有者），需自行完成所有步骤，仅在决策和需要浏览器操作时询问本人。\n\n主要能力与流程：\n0. 一次性与本人确认：仓库 OWNER/NAME（新建，或已有仓库则跳至第6步）、应用标题、运行时（vm：自有主机容器，agent 随应用运行，默认；cloudflare：Worker + D1，agent 为声明式、由 hub 运行，无代码 agent、无 job）、专家 GitHub 登录名（不能与 bot 相同）、bot 账号（令牌存于 FACTORY_TOKEN，默认即维护者）。\n1. 前置检查：gh auth status、gh auth setup-git、gh api repos/hachej/boring-factory --jq .full_name、gh api repos/hachej/boring-app --jq .is_template（须为 true）、gh api repos/hachej/boring-factory/actions/permissions/access --jq .access_level（须为 user）。若不是 user：gh api -X PUT repos/hachej/boring-factory/actions/permissions/access -f access_level=user。另需本人确认已安装 Claude GitHub App 且可访问所有仓库，Cursor 工人还需 Cursor GitHub 集成能看到该仓库并启用了按需用量。\n2. 三个密钥，切勿打印明文，用管道写入：FACTORY_TOKEN（bot 令牌，bot 即登录维护者时用 gh auth token）、CURSOR_API_KEY（维护者的 Cursor 密钥）、CLAUDE_CODE_OAUTH_TOKEN（仅本人可生成，claude setup-token，Claude Pro/Max；不要让其在对话中粘贴，由其自行 gh secret set 或先行 export）。尽量在 §3 前 export。\n3. 创建仓库：先试运行并向本人复述计划，再执行 init，如 npx -y github:hachej/boring-factory init OWNER/NAME --expert EXPERT --bot BOT --title "TITLE" --runtime vm（确认时加 --yes）。init 会从模板 hachej/boring-app 建私有仓库（gh repo create --template），推送一次提交完成应用化（名称、标题、端口、运行时，scripts/init-app.mjs 只保留 deploy/<runtime>/；CODEOWNERS；project.md 中的专家），应用标签与设置、邀请专家、设置环境中的密钥与 FACTORY_BOT 变量，之后补齐报告缺失的密钥。生产部署稍后按应用内 deploy/<runtime>/DEPLOY.md 手工完成；Cloudflare 生产令牌只放在受限 main 的 GitHub 环境 production，预览使用另一账号令牌。\n4. 验证：gh secret list、gh variable list、gh label list --limit 100 | wc -l（26 或更多）、gh api repos/OWNER/NAME/invitations、gh run list --limit 5。main 上首次 ci 的 paths 为红属预期；check 必须为绿，若红则先修模板 hachej/boring-app，再通过 PR 修应用。\n5. 交接到专家：告知接受邀请，并在本机执行 npx skills add hachej/boring-stack --skill boring-pm -g 且 gh repo clone OWNER/NAME，在克隆目录内打开 agent（Claude Code、Codex 或 Cursor）描述需求；提醒维护者关注 Actions 中 factory 工作流（context → ci → triage → checks → gates → build）、triage 每次事件一条评论，以及每个 PR 上的 boring/ci 与 boring/proof 检查。\n6. 已有仓库：npx -y github:hachej/boring-factory sync OWNER/NAME --dry-run（确认时 --yes），生成标签与“Adopt the Boring Factory”PR；该 PR 只补齐缺失文件（factory.yml caller、forms、PR 模板、CODEOWNERS、ask 规则、project.md），在其分支填好 project.md 的 setup 与 check，手工合并一次后方生效，随后执行 §2、§4、§5。这是一次性采用，之后不再跟踪或升级。\n常见故障：factory/context 报 404 多为工厂 bug 或令牌无权限；job 提示无法使用工作流说明未共享，检查 §1 的 access level；新应用 check 红多为模板 bug；Cloudflare 应用拒绝含 index.mjs、job 或 Node 服务端代码的 agent 时改为声明式或选 vm；triage 或 claude worker 不运行多为 CLAUDE_CODE_OAUTH_TOKEN 缺失或过期；专家无法批准合约 PR 说明专家用了 bot 账号；Cursor 任务立即失败与配额或 GitHub 集成有关；npx 无法拉取时执行 gh auth setup-git。归因于工厂或模板的问题应在其仓库修复，不要只补应用。\n限制：本技能面向已使用 Boring Factory 的维护者；生产部署需手工按 DEPLOY.md 完成，且资料未提供定价、平台支持范围与效果保证等信息，暂未提供。