Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

関門 3: 触れる版

オープン
#18 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
github-actions, typescript
領域
devtools

調査の方向性

Start with the README’s Usage section and this issue’s local setup steps; the issue also describes testing a deployed instance after completing issue #3. Try the preview flow and report whether to proceed with publication, what would need to change if not, and any concerns. Done means providing that feedback; this is a readiness review rather than a scoped code change.

索引モデルが issue の本文から書いたものです。

説明

触れる最初の版が main に入りました。触ってみて、公開 (bannzai 自身のインスタンスを Cloudflare にデプロイして使い始める・README を使える状態として告知する・判定の 14 日周期を始める) に進むかをコメントで返してください。返答を待つ間も、残りの実装とマージは続けます。

ロードマップ: https://github.com/bannzai/pre-github/issues/4

触り方

本番の Cloudflare へのデプロイは、Secrets と D1 の登録 (ユーザー作業の一覧 https://github.com/bannzai/pre-github/issues/3 ) が済んでいないため、まだ行っていません。手元で触る場合:

cd /Users/bannzai/ghq/github.com/bannzai/pre-github
git checkout --detach origin/main
npm ci
npm run migrate:local
npx wrangler dev --var PRE_GITHUB_TOKEN:local-token

別のターミナルで、preview したいリポジトリのブランチに移動してから API に送ります (手元の wrangler dev は http のため、https で叩く gh api --hostname と scripts/preview-pr.sh ではなく curl を使います)。

jq -n --arg title "試し" --rawfile body body.md --rawfile diff <(git diff origin/main...HEAD) \
  '{title: $title, body: $body, head: "feature", base: "main", diff: $diff}' |
  curl -sS -X POST http://127.0.0.1:8787/repos/bannzai/example/pulls \
    -H 'Authorization: token local-token' -H 'Content-Type: application/json' --data @- | jq -r .html_url

出力された URL を Chrome で開き、token (local-token) を入力すると preview が表示されます。scripts/preview-pr.sh を使う経路 (README の「Usage」) は、Cloudflare にデプロイしたインスタンス (下の手順) で試せます。

このコマンドは開発マシンでビルドとサーバーを動かします。agent は「ビルドとブラウザの確認を開発マシンで行わない」方針のため実行していません。agent が確認したのは、GitHub Actions の runner 上で wrangler dev に対して E2E が撮った下の画面です。

Cloudflare に置いて触る場合 (公開に進む時と同じ手順): issue #3 の「bannzai 自身のインスタンス用の Cloudflare の Secrets と D1 を用意する」を行い、gh workflow run deploy.yml -R bannzai/pre-github を実行します。

画面 (GitHub Actions の runner 上の E2E。PR #13 の run 37358445167 / 37363336013 の artifact)

PR の preview:

PR ページ

issue の preview:

issue ページ

ログイン:

ログイン画面

必要な機能の充足状況

機能 状態
GitHub 互換の REST API (issues / pulls / comments、/api/v3/ の prefix、PR の diff) 入っている (#5、PR #12)
認証 (1 つの token。API は Authorization ヘッダ、ページは Cookie のログイン) 入っている (#5・#6)
GitHub 風の HTML ページ (Markdown の描画、PR のファイルごとの差分) 入っている (#6、PR #13)
削除 (API の DELETE とページの削除ボタンで D1 から完全に消す) 入っている (#5・#6)
セルフホストの手順と送信の補助スクリプト (preview-pr.sh / preview-issue.sh) 入っている (#7、PR #15)。README の呼び出しを別リポジトリから動く形にする修正を #17 で実装中
利用記録 (D1 の events テーブル) 入っている (#5)
漏えい候補の強調 (電話番号・メール・ホームのパス・API キーらしい文字列) 入っている (#8、PR #16。この issue の投稿後の 2026-10-06 にマージ)

未検証のこと

  • 本物の Cloudflare (本番の D1・Workers) での動作。CI は local D1 の wrangler dev でだけ確認しています
  • 本物の gh でスクリプトから送る経路。スクリプトのテストは gh をスタブに差し替えています
  • (解消済み) 壊れた multipart の POST /login の 500 は #14 として PR #16 で対応し、close しました

返答してほしいこと

  1. 公開に進むか (進む / まだ)。「まだ」の場合は、何が入れば見せ直すか (例: 漏えい候補の強調が入ってから)
  2. 触って気になった点があれば

セッション再開

cd /Users/bannzai/ghq/github.com/bannzai/pre-github
claude --resume b84d4d55-461c-45bd-b620-736664c946b7
主要言語
TypeScript
スター
0
フォーク
0
平均マージ
1時間 23分
マージ済み PR(30日)
9

環境構築

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

bannzai/pre-github のほかの issue

bannzai/pre-github の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。