Claude Codeで未レビューのサイト変更を避けてPageSpeed SEO監査を実行する方法

Claude Codeは、PageSpeedの結果をリポジトリ内のテンプレート、コンポーネント、アセット処理へ結び付ける場面で役立ちます。ただし、証拠収集とサイト変更は別の状態です。このガイドでは、監査は読み取り専用、実装は人が狭い計画を承認してから、というプロジェクト内のSkillを作ります。

この記事をClaude Codeへ送ってSkillを作成する

記事のURLと次の依頼をClaude Codeへ渡します。インストール時に公開URLを測定したり、アプリケーションを変更したりしないことが重要です。

Read [THIS ARTICLE URL] and install its project-local PageSpeed audit workflow.

First inspect this repository for CLAUDE.md, CLAUDE.local.md, .claude rules,
and project conventions. Explain where these files will go before writing them:
.claude/skills/pagespeed-evidence/SKILL.md
.claude/skills/pagespeed-evidence/scripts/pagespeed_evidence.py
.claude/rules/page-speed-audits.md

Create each file from the complete code blocks in the article. Do not change
application code, package files, lock files, CI, infrastructure, or deployment
configuration. Do not call PageSpeed Insights or inspect public URLs.

Run a Python syntax check on the runner. Report the paths, confirm audit output
is ignored by Git, and tell me to configure PAGESPEED_API_KEY in my approved
local secret environment without revealing or requesting the value. Stop there.

CLAUDE.mdや.claudeのルールは持続的なプロジェクト指示として有用ですが、それだけで技術的な強制境界にはなりません。強制が必要な組織では、現在の公式ドキュメントに従い、Claude Codeの権限やPreToolUseフックも使います。

完成条件とリポジトリ境界

監査結果はreports/pagespeed/だけに書き込み、必ずGitから無視させます。

mkdir -p reports/pagespeed
printf 'reports/pagespeed/
' >> .gitignore
git check-ignore -v reports/pagespeed/example/report.md

.claude/rules/page-speed-audits.mdに置くポリシー

# PageSpeed audit policy

- PageSpeed work starts as read-only evidence collection. Write audit output only under reports/pagespeed/, which must stay ignored by Git.
- Read PAGESPEED_API_KEY only from an approved local environment or secret mechanism. Never print it, add it to a command transcript, write it to a report, or commit it.
- Do not edit application source, content, build files, CI, infrastructure, deployment configuration, or a CMS while collecting or interpreting an audit.
- After an audit, create an implementation brief that names evidence, candidate files, risk, tests, acceptance criteria, and rollback condition. Wait for explicit approval before making a diff.
- Never deploy. After an approved implementation, show the Git diff and run only agreed local validation commands.

読み取り専用の証拠Skillを作る

.claude/skills/pagespeed-evidence/SKILL.mdには、公開PageSpeed APIと公開サイトマップだけへGETし、reports/pagespeed/の下だけへraw JSON、report.md、summary.jsonを書き込むことを定義します。モバイルとデスクトップを必ず測定し、Lighthouseをラボデータとして、loadingExperienceとoriginLoadingExperienceを返却時だけ別スコープのCrUXとして表示します。監査後は編集せず、根拠、候補ファイル、最小変更、リスク、テスト、受入条件、ロールバックを含むブリーフを作り、承認を待ちます。

python3 .claude/skills/pagespeed-evidence/scripts/pagespeed_evidence.py \
--url "https://www.example.com/" \
--out reports/pagespeed/homepage-baseline

期待される出力はreport.md、summary.json、モバイル/デスクトップのraw JSONです。git status --shortにレポート成果物が現れないことを確認します。403はGoogle API設定またはキー制限、CrUXが空なのはAPIが対象フィールドデータを返さなかったこと、429/5xxは限定リトライ後に失敗として残ることを意味します。

証拠からレビュー可能な実装ブリーフへ

監査の次にClaude Codeへ渡す依頼は、まだ読み取り専用です。

Read reports/pagespeed/homepage-baseline/ as evidence and inspect this repository read-only. Produce an implementation brief only.

For each prioritized opportunity, cite the relevant report row or raw response,
name candidate templates, components, asset tooling, or configuration files,
and explain why they are candidates. Propose the smallest safe change. Include
expected benefit, risk, local validation, production acceptance criteria, and a
rollback condition. Do not edit any file or deploy. Wait for approval.

承認後だけ、名前を挙げたパスだけを変更し、git diff、合意済みのローカルテスト、プレビューでの同一スコープ再測定、ロールバック条件を提示します。テスト成功はCore Web Vitals改善の証明ではありません。

検証チェックリスト

• [ ] Skillは.claude/skills/pagespeed-evidence/SKILL.mdにある。
• [ ] reports/pagespeed/はGitから無視され、APIキーはローカルの承認済みシークレットだけにある。
• [ ] URLごとにモバイル/デスクトップ、raw JSON、最終URL、失敗が残る。
• [ ] Lighthouseとページ/オリジンCrUXが分けて記録される。
• [ ] Claude Codeはソース編集前に実装ブリーフを作り、承認済み変更には小さなdiff、テスト、ロールバック条件がある。
• [ ] 監査にも実装にもデプロイ権限を与えていない。

よくある質問

CLAUDE.mdだけでファイル変更を防げますか？

いいえ。持続指示としては有効ですが、強制機構ではありません。禁止すべき操作にはリポジトリの権限とフックを使い、同時にこのポリシーで人とエージェントに意図した作業モデルを明示します。

Author: Julian Mercer, AuspiaのTechnical SEO Practitioner。Julianは、SEOの発見からレビュー済みのWebサイト変更まで、明確な証拠の流れを残す技術ワークフローを執筆しています。