Repository navigation
ci(quality): setup を composite action にし、品質ゲートを並列ステップで縮める - #32
Merged
Merged
Conversation
pnpm・Node・install の 3 ステップが ci.yml に 3 回、preview-cleanup.yml に 1 回あったので、.github/actions/setup にまとめる。 install スクリプトは既定で止め(--ignore-scripts)、install-scripts: "true" のときだけ動かす。トークンを持たない ci ジョブだけが指定し、Preview・本番・ Preview の削除のジョブは既定のままにする。true / false 以外の値は失敗させる。 Refs #30
Playwright のブラウザと lychee を background で入れ、lint・format・ astro check を parallel にする。build は astro check と同じ .astro/ に 書くので、このグループから外す。links と a11y の前で、それぞれ必要な インストールを wait する(background のステップの GITHUB_PATH は wait まで反映されない)。 a11y と Lighthouse は直列のままにする。同じマシンで CPU を奪い合うと Lighthouse の Performance が変動するため。 Refs #30
kryota-dev
marked this pull request as ready for review
October 14, 2026 04:29
kryota-dev
commented
Oct 14, 2026
kryota-dev
left a comment
Owner
Author
There was a problem hiding this comment.
Multi-Review 統合レビュー結果
総合評価
| カテゴリ | general(Codex, xhigh) | security(subagent) |
|---|---|---|
| MUST | 0 | 0 |
| SHOULD | 0 | 0 |
| NITS | 1 | 4 |
| GOOD | 4 | 5 |
specialist は立てていない(変更は YAML と Markdown だけで、条件に当たるものが無い)。
セキュリティ
- 総合リスクレベル: Low / この PR で新しく生じた脆弱性: 0 件
- Cloudflare のトークンを持つ 3 つのジョブ(preview / deploy / preview-cleanup)は、変更前と同じく
--ignore-scriptsで依存を入れる。ローカル action は、どのジョブでも checkout の後に参照されている。pull_request_targetの preview-cleanup では base 側のaction.ymlが読まれるので、PR 側のコードは動かない
[MUST] / [SHOULD]
なし。
[NITS]
docs/deployment.md:24(general): 「トークンを持たないciジョブ」は不正確。ciにもcontents: readのGITHUB_TOKENがある。「Cloudflare のトークンを持たない」とするのがよい.github/workflows/ci.yml:27-29(security。未確認の前提あり):allowBuildsは 2 つともfalseで、ルートのpackage.jsonにライフサイクルスクリプトも無い。そのため、install-scripts: "true"にしても、今は実行されるスクリプトが変わらない。ただし、--ignore-scriptsを付けるとstrictDepBuildsの検査(許可していないビルドスクリプトを持つ依存が入ったら失敗させる)が飛ばされるのなら、ciジョブで"true"にしておく意味がある。pnpm 10.28 でこの挙動は確かめきれていない.github/workflows/ci.yml:39-53(security): 同時に走る lint / check / build が、lychee の sha256 検証と展開の間にアーカイブを差し替えることは原理上できる。ただし、それらは同じジョブで同じ権限を持ち、変更前から$GITHUB_PATHを書き換えられた。ciジョブには secret も書き込み権限も無い。新しい権限は得られないので、悪用経路にはならない- (範囲外・既存)
.github/actions/setup/action.yml:17-20(security): main ではci(依存のコードを実行する)とdeploy(本番トークンを持つ)が、同じスコープの pnpm のキャッシュを共有する。依存が侵害され、キャッシュを書き込めた場合にdeployの復元が汚染されうる(キャッシュが外れた run に限られ、pnpm のストアの整合性検証もあるので難度は高い。未確認)。この PR では悪化していない。setup を composite にまとめたので、トークンを持つジョブだけキャッシュを切る対策を 1 箇所で入れられる。別の issue で扱う候補 - (範囲外・既存)preview environment には制限が無い。ただし、同じリポジトリに push できる人は、もともと workflow を書き換えられる。fork PR は除外されている
[GOOD]
.github/actions/setup/action.yml:25: 入力を env で受け、true/false以外を失敗させている。式の展開によるインジェクションは起きない(general / security).github/actions/setup/action.yml: install スクリプトを既定で止めている。今後ジョブを足して指定を忘れても、安全な側に倒れる(security).github/workflows/ci.yml:56: build を parallel から外し、.astro/への書き込みが astro check とぶつからないようにしている。ESLint と Prettier は.astro/を無視している(general).github/workflows/ci.yml:73,79: lychee と Playwright を、使う直前にそれぞれ wait している。lychee の完全性検証も保たれている(general / security)- 失敗時のレポートのアップロードと、ゲートを通ったときだけの artifact の保存は、変更前のまま(general)
- spec(requirements / design / tasks)との整合: タスク 1〜4 に取りこぼしや逸脱は無い。タスク 5(CI での確認)は PR 作成後の作業(general / security)
事実検証で棄却した指摘
なし。
既存指摘との重複
既存のレビューと行コメントは無い(github-actions の Preview URL のコメントだけ)。除外は 0 件。
ci ジョブにも GITHUB_TOKEN はあるので、持たないのは Cloudflare の トークンだと書く。 Refs #30
Owner
Author
|
review body にだけある指摘への対応です。
|
1 task
This was referenced Oct 14, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
ワークフローに 4 回あった setup(pnpm + Node + install)を composite action にまとめ、品質ゲートのジョブを並列ステップで縮める。ワークフローの分割(#31)の前段で、必須チェック名と配信の振る舞いは変えない。
設計は #29 の方針どおり。意図と範囲は #30 の起票時に合意したので、着手前の確認は省いた。
closes #30
変更内容
.github/actions/setupを足した。pnpm/action-setup・setup-node(cache: pnpm)・pnpm install --frozen-lockfileを行う。install スクリプトは既定で止め(--ignore-scripts)、install-scripts: "true"のときだけ動かす。それ以外の値なら失敗するciジョブ(install-scripts: "true")、preview・deploy・preview-cleanup.yml(既定)の setup を、この action に置き換えたciジョブを並べ直したbackgroundで入れるparallelにする。build は、astro check と同じ.astro/に書くので、このグループから外したwaitする(background のステップのGITHUB_PATHは wait まで反映されない)確認したこと
pnpm lint/pnpm format:checkが通る(ローカル)pnpm check/pnpm build/pnpm test:html/pnpm test:links/pnpm test:a11y/pnpm test:lighthouseが通る(CI。サイトのソースは変えていない)必須チェック
Lint, build, and quality gatesが同じ名前で報告されるPreview のジョブが通る
品質ゲートの所要時間を比べた(下の表)。a11y を始めるまでが約 17 秒縮んだ。ジョブ全体では、Lighthouse の揺れ(今回は 81 秒)の幅の中に埋もれている
Playwright のインストール(30 秒)は lint・check・build の裏に隠れた。並列にした lint は 4 → 8 秒、astro check は 8 → 14 秒に延びたが、グループ全体は 14 秒に収まった
マージ後: main で本番デプロイとヘッダー検査が通る/PR を閉じると Preview が消える
手動の a11y チェック(画面に影響する変更のとき)
画面に影響しないので該当しない(ワークフローと文書だけの変更)。
関連