Communitygithub.com

h1sort/claude4aieng 部署工具

將「Tool use sin abstracciones」簡報即時發佈或更新至 h1sort.com/claude4aieng,透過同步公開建置內容至 h1sort-website 儲存庫。適用於每次編輯簡報後,或當被要求發佈、部署、重新整理或更新網站上的投影片時。

claude4aieng 部署工具 是什麼?

此技能用於將位於 `claude4aieng` 儲存庫中的簡報「Tool use sin abstracciones」部署至 `h1sort.com/claude4aieng`。它自動化了一個多步驟流程:首先確認原始簡報已透過 `assemble.mjs` 和 `shot.mjs` 指令建置驗證;其次,產生一份公開版 HTML(移除筆記、停用控制列),並在投影片 1 變更時,以 Playwright 渲染 1200×630 的 OG 圖片;接著,將產出檔案複製至 `h1sort-website` 儲存庫的新分支,在本地建置並比對結果;最後,透過 Wrangler 進行路由冒煙測試(檢查 `/claude4aieng` 的 307/200 狀態碼及既有頁面)。此技能僅提交與簡報相關的檔案(避免 `git add -A`),並透過分支推送觸發 Workers Builds 生產部署(約 2.5 分鐘),然後立即合併 PR,確保 `main` 分支與線上內容一致。它支援 Claude Code 與任何可執行 shell 指令的 AI 代理平台。

相容平台✓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/
cover (slide 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. OG 圖片 僅當投影片 1 變更時:以 Playwright(deck/node_modules)渲染 ?still=1&solo=1&slide=1 的 1200×630,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 分鐘)。推送、開啟 PR 並立即合併,以便 main 與線上內容一致;確認合併提交上的「Workers Builds」檢查已成功。

經驗記錄

  • 2026-10-18 · main 自 2026-10-13 起落後於生產環境:Snowflake 演講從 feat/snowflake-world-tour 分支部署(分支推送 = 部署)且從未合併。已以 PR #20 合併(樹狀結構與已部署分支相同,無可見變更)。規則:務必在分支部署的當天合併。
  • 2026-10-18 · 首次掛載 /claude4aieng/ 透過 PR #21(039a04b),來自 claude4aieng b1b7e43。建置與部署檢查成功。
  • 2026-10-18 · 從 Claude Code 雲端工作階段中無法刪除分支(API 與 git push 皆回傳 403);請從 GitHub 介面刪除已合併的分支。
  • 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 張。部署成功。

相關技能