ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
全143件(更新が新しい順)
- Search Consoleの登録と日常の使い方(プロパティ・所有権確認・サイトマップ・URL検査・検索パフォーマンス) ドメインプロパティ(DNSのTXTで確認)で登録し、サイトマップを送信、個別ページはURL検査で確認する。検索での見られ方はSearch Console、サイト内の行動はGA4と使い分ける。
- 安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認) 戻せる状態を作ってから変える。バックアップ→書き込みなしの試し実行→本番→差分検証→表示検査。普段は変更部分だけ検査し、全件検査は大きな節目だけ。
- 公開後検査(公開後チェック)の項目と方法(HTTP・H1・href="#"・実クリック・スマホ390px・横スクロール・既存差分) 公開後チェック。新規・変更ページに対して、サーバー側verify、HTTP/H1/プレースホルダ/href="#"、PC・スマホ390pxの実クリック、横スクロール、既存ページ差分を確認する。全体監査は節目だけ。
- 速度改善の実務手順(遅いページ特定→原因確認→1つずつ修正→再測定→PC/スマホ実動作確認) 遅いページを特定し、原因候補を画像→外部埋め込み→CSS/JS→プラグイン→キャッシュ→サーバーの順に確認。バックアップを取って1つずつ直し、再測定とPC/スマホの実動作確認をする。いきなり設定を大量に変えない。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- 障害対応の基本(いきなり直さず症状を切り分ける14の確認順) 何が・いつから・全員か一部か・端末・回線を確認してから、DNS→サーバー→WordPress→プラグイン→外部サービス→ログ→直前変更の順に原因を絞る。修正はバックアップを確認してから1つずつ。
- Gitの安全な使い方(commit前にstatus/diff・秘密情報をcommitしない・.gitignore・消しても履歴に残る) commit前に git status と git diff で対象と中身を確認し、git add . をむやみに使わない。.env・wp-config.php・鍵・APIキーは .gitignore で除外する。一度commitした秘密情報は、後で消しても履歴・コピー先に残るので、まずその認証情報を無効化・変更する。
- HP制作でGitを使う(変更履歴・差分確認・元に戻す・複数人作業)とバックアップとの違い・WordPressで管理できない部分 Gitはテーマ・子テーマ・独自プラグイン・静的HTML/CSS・スクリプト・原稿など「ファイル」の変更履歴と差分確認に強い。WordPressのDB(記事・設定)やuploadsの画像は基本Gitで管理しないので、バックアップは別に必要。本番WordPressそのものとGitのリポジトリは別物。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- バックアップ方針(作業前に必ず取り、削除しない) WordPressへ書き込む作業の前に毎回新しいバックアップを取る。名前は wg-backup-YYYYMMDD-<作業名>。古いバックアップは削除しない。設定を変えるときは変更前の値をファイルに残す。
- WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ) まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
- スマホで横スクロールが出る(はみ出し要素の探し方と直し方) scrollWidth と clientWidth の差で横スクロールを判定し、右端をはみ出す要素をコンソールで探す。原因は固定幅・100vw・長い英数字・負のmargin・1frのグリッドなど。overflow-x:hidden で隠すのは最後の手段。
- 検索に出ない・Search Consoleで「インデックス未登録」になる原因と対処 まずURL検査でnoindex・robots・canonicalを確認する。設定起因(noindex・robots・canonical・リダイレクト)は直せばよく、「クロール済み/検出 - 未登録」は品質・内部リンク・新しさの問題で時間がかかる。
- GA4にデータが出ない・数値がおかしい(計測されない・二重計測・CVが取れない) まずソース表示で測定IDのタグが1回だけ出ているか、リアルタイムに自分が出るかを見る。出ない→タグ未設置・ID違い・キャッシュ・GTM未公開、2倍→二重設置、CV0→イベント名違い・キーイベント未指定。
- DNS変更・サーバー移転後に表示されない(DNS未反映か、新サーバー側の問題かを分ける) まず今そのドメインがどのIPを向いているかを確認し、「DNSがまだ旧サーバーを向いている(反映待ち・キャッシュ・hosts)」と「新サーバーを向いているのに壊れている(設定・SSL・ファイル)」を分ける。前者は待つかキャッシュを消す、後者は新サーバーを直す。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意) サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
- サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ) 小カテゴリ1つ(8記事)ごとにサブエージェントを1つ立て、共通ブリーフで原稿を書かせる。戻り値はファイルパスとH2一覧だけにして本文を返させない。文字数は len.ps1 で確認する。
- CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ) CLAUDE.mdは作業フォルダで毎回守るプロジェクト固有ルールの置き場。変更禁止・作業範囲・検索/検査ルール・noindexなどの恒久ルール・優先順位を短く書き、手順や詳しい知識は knowledge に置いてリンクや検索で参照させる。
- auto mode の安全チェックでサーバー書き込みが止められたときの対応 サーバーへの書き込みコマンドが auto mode に止められたら、分割や別手段で回避しない。止められた内容を報告し、/permissions での許可か通常の確認画面を待つ。
- AIへの作業依頼の型(目的・対象・禁止事項・検査・報告形式) 目的・対象・現状・やること・禁止事項・検査・止める条件・報告形式を分けて書く。guidepocket.net 制作で繰り返し使い、手戻りが少なかった指示の型。
- 「他は変更しない」指示の定型文(指定箇所だけ変更・追加のみ・調査のみ) AIが「ついでに整える」のを防ぐ定型文を3種類(指定箇所だけ変更/追加だけ/調査だけ)。変えてよい範囲を具体名で書き、他に必要な変更は「実施せず報告」させ、差分で確認する。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- AIにHTML/CSS修正を頼むときの安全な指示(指定箇所以外を変更させない) 変更範囲・変えてよい値・禁止事項を明示し、新しいCSSは専用クラスに限定、作業後は変更前との差分とスクショで「指定箇所以外が変わっていない」ことを機械的に確認させる。
- AIで表示速度を改善するときの任せ方(調査・一覧化・改善案はAI、本番変更の判断は人) HTML/CSS/JSの確認、重そうな要素・画像・外部スクリプトの一覧化、改善案、変更前後の比較はAIに任せやすい。本番への大量変更、プラグイン削除、キャッシュ・CDN・サーバー設定、本番JSの一括最適化はAIだけで判断しない。必ずバックアップと検証を伴う。
- 自動化するか手作業にするかの判断(繰り返し・定型・大量・検査は自動化向き、一度きり・判断が多い・仕様が揺れるものは手作業) 繰り返し・定型・大量・チェック・変換・一覧化・バックアップ・検査は自動化向き。一度しかやらない、判断が多い、仕様が頻繁に変わる、自動化を作る方が時間がかかるものは手作業かAIとの対話で。何でも自動化すればよいわけではない。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。