Communitygithub.com

h1sort/claude4aieng

发布或刷新 h1sort.com/claude4aieng 上「Tool use sin abstracciones」演示文稿的实时副本,通过将公共构建同步到 h1sort-website 仓库实现。在编辑演示文稿后,或当被要求发布、部署、刷新或更新网站上的幻灯片时使用。

claude4aieng 是什么?

该技能(SKILL)用于将名为「Tool use sin abstracciones」的演示文稿从源代码仓库发布到 h1sort.com/claude4aieng 网站。它的核心工作流包括:在源代码仓库中运行构建脚本(assemble.mjs)生成公开构建版本,提取社交卡片图片(OG image),将文件复制到 h1sort-website 仓库的指定目录,然后在 Cloudflare Workers 开发服务器上进行路由冒烟测试。最后,通过提交 Pull Request 并立即合并来触发生产部署(Workers Builds),确保主分支与线上环境一致。该技能支持多个 AI Agent 平台(如 Claude Code、Cursor、Codex),并解决了诸如分支部署后立即合并以避免回退、通过 GitHub UI 删除已合并分支(因为 Cloud Code 云会话会阻止 git push)等实际运维问题。它设计为幂等操作:每次执行都会基于当前源代码生成全新的公开副本。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/h1sort/claude4aieng/tree/HEAD/.claude/skills/publish-to-site

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

将演示文稿发布到 h1sort.com/claude4aieng

此仓库是唯一事实来源。 h1sort-website 仅保存生成的公开副本。切勿在网站仓库内编辑演示文稿。

claude4aieng/deck/src/**  ──assemble.mjs --public──▶  h1sort-website/public/claude4aieng/index.html  ──▶  h1sort.com/claude4aieng/
封面(幻灯片 1)1200×630 JPEG                    ──▶  h1sort-website/public/claude4aieng/og.jpg

步骤

  1. 在此提交演示文稿。 运行 node deck/tools/assemble.mjs --expect 40:00 和 node deck/tools/shot.mjs deck/tool-use.html,两者都通过后,提交并推送 main 分支。
  2. 公开构建: 运行 node deck/tools/assemble.mjs --expect 40:00 --public --out <scratch>/index.html。它会剥离所有 <aside class="notes"> 并添加 data-public(无控制栏;N、P、? 被禁用)。检查:grep -c 'class="notes"' 结果为 0。
  3. 仅当幻灯片 1 发生变更时生成 OG 图片: 使用 Playwright(deck/node_modules)以 1200×630 渲染 ?still=1&solo=1&slide=1,JPEG 质量约 82,确保图片小于 300 KB。
  4. 网站仓库: 运行 git checkout main && git pull,新建分支 chore/refresh-claude4aieng,将文件复制到 public/claude4aieng/ 目录,运行 npm ci && npm run build,确认 cmp dist/claude4aieng/index.html public/claude4aieng/index.html 一致。
  5. 冒烟测试真实路由: 在后台运行 npx wrangler dev --port 8799,配合 timeout 命令;检查 /claude4aieng 返回 307,/claude4aieng/ 返回 200,/snowflake/ 和 /gbm-ai/ 仍返回 200。使用 timeout 停止进程,而不是 pkill -f 'wrangler dev'(后者会匹配到运行该命令的 shell 并杀死你自己的命令)。
  6. 仅提交演示文稿相关路径: 只提交 public/claude4aieng 路径(以及如果变更了的 astro.config.mjs / public/llms.txt)。切勿使用 git add -A。
  7. 任何分支推送都会触发生产部署: (Workers Builds,约 2.5 分钟)。推送,创建 Pull Request 并立即合并,以确保 main 与线上环境一致;确认合并提交上的「Workers Builds」检查已成功。

经验日志

  • 2026-10-18 · main 自 2026-10-13 以来落后于生产环境:Snowflake 演讲是从 feat/snowflake-world-tour 分支部署的(分支推送即触发部署),但从未合并。已作为 PR #20 合并(树结构与已部署分支相同,无可见变更)。规则:分支部署当天务必合并。
  • 2026-10-18 · 通过 PR #21(039a04b)首次挂载 /claude4aieng/,来源为 claude4aieng b1b7e43。构建和部署检查均成功。
  • 2026-10-18 · 从 Claude Code 云会话中无法删除分支(API 和 git push 均返回 403);请从 GitHub UI 删除已合并的分支。
  • 2026-10-18 · 通过 PR #22(3aaff2f)刷新,来源为 claude4aieng 2d87bab,在实时演练后(第 16 张幻灯片上的测量表格)。部署成功。
  • 2026-10-18 · 要检查 GitHub 上的 paso-* 分支,请使用 git ls-remote origin 'paso-*' 或显式获取它们(git fetch origin '+refs/heads/paso-*:refs/remotes/origin/paso-*'):在此浅克隆中,普通的 git fetch 仅更新 main,导致 origin/paso-* 引用过时。
  • 2026-10-18 · 通过 PR #23(403f357)刷新,来源为 claude4aieng 508bb0a:Rotura #1b 幻灯片,共 18 张。部署成功。

相关技能