Communitygithub.com

h1sort/claude4aieng

「Tool use sin abstracciones」デッキの公開コピーをh1sort.com/claude4aiengに公開または更新します。デッキの編集後、またはスライドの公開・デプロイ・更新が求められた際に使用します。

claude4aieng とは?

このスキルは、`h1sort/claude4aieng` リポジトリ内の「Tool use sin abstracciones」デッキ(Markdownベースのスライド)を、h1sort.com 上のライブコピーとして公開・更新するための自動化パイプラインを提供します。デッキの編集後、スライドの公開・デプロイ・リフレッシュが求められた際に実行します。 スキルは、アセンブルスクリプトを使用して公開ビルドを生成し、講演者ノートを除去し、コントロールバーを無効にします。さらに、OG画像の生成、`h1sort-website` リポジトリへのファイルコピー、ルーティングのスモークテスト、そして本番環境への自動デプロイ(Cloudflare Workers Builds)を一貫した手順で行います。 主な対応プラットフォームはClaude Code(クラウドセッションやローカル実行)で、GitHub ActionsやカスタムCIは不要です。スキルはGit操作、ビルドスクリプトの実行、デプロイ確認をすべて手動ステップとして定義しており、人間の判断を介入させつつも再現性を高めています。 特に重要なのは、デッキのソースはこのリポジトリが唯一の真実であり、`h1sort-website` には生成物のみを配置するというルール、マージとデプロイの同期を確実に行うための教訓ログの活用、そしてブランチ削除やリモート参照の最新化に関する実践的な注意点です。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デッキを 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が変更された場合のみ: ?still=1&solo=1&slide=1 を 1200×630 で Playwright(deck/node_modules)を使ってレンダリング、JPEG品質 ~82、300KB 未満に抑えます。
  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' は使用しないでください(そのパターンはシェル自身も kill してしまいます)。
  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 · 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枚。デプロイ成功。

関連スキル