ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
状態: 参考 96件
絞り込みを解除- 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・ファイル)」を分ける。前者は待つかキャッシュを消す、後者は新サーバーを直す。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意) サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
- CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ) CLAUDE.mdは作業フォルダで毎回守るプロジェクト固有ルールの置き場。変更禁止・作業範囲・検索/検査ルール・noindexなどの恒久ルール・優先順位を短く書き、手順や詳しい知識は knowledge に置いてリンクや検索で参照させる。
- 「他は変更しない」指示の定型文(指定箇所だけ変更・追加のみ・調査のみ) AIが「ついでに整える」のを防ぐ定型文を3種類(指定箇所だけ変更/追加だけ/調査だけ)。変えてよい範囲を具体名で書き、他に必要な変更は「実施せず報告」させ、差分で確認する。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- AIで表示速度を改善するときの任せ方(調査・一覧化・改善案はAI、本番変更の判断は人) HTML/CSS/JSの確認、重そうな要素・画像・外部スクリプトの一覧化、改善案、変更前後の比較はAIに任せやすい。本番への大量変更、プラグイン削除、キャッシュ・CDN・サーバー設定、本番JSの一括最適化はAIだけで判断しない。必ずバックアップと検証を伴う。
- 自動化するか手作業にするかの判断(繰り返し・定型・大量・検査は自動化向き、一度きり・判断が多い・仕様が揺れるものは手作業) 繰り返し・定型・大量・チェック・変換・一覧化・バックアップ・検査は自動化向き。一度しかやらない、判断が多い、仕様が頻繁に変わる、自動化を作る方が時間がかかるものは手作業かAIとの対話で。何でも自動化すればよいわけではない。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- HP制作でのAIの役割分担(チャット型AIとClaude Codeの使い分け) 相談・文章・部分的なコードはチャット型AI、ファイル一括処理・コマンド・検査の自動化はClaude Codeのようなエージェント型。具体的な機能・料金・モデル差は変わるので都度確認する。
- CTAと料金表の見せ方の基本 CTAは1画面に主な行動を1つ、何が起きるか分かる文言で、読み終わった位置に置く。料金表は比較の軸をそろえ、合計・税・条件を明記し、スマホでは縦積みか横スクロール枠で崩さない。
- YouTube動画の埋め込み(レスポンシブ16:9・遅延読み込み・サムネイル方式)と自サーバー動画との違い iframeを aspect-ratio:16/9 の枠に入れて width/height 100%。画面外は loading="lazy"。複数置くなら、サムネイル画像を表示してクリックで iframe に差し替える方式にする。長い・大きい動画はYouTube、短い装飾ループだけ自サーバーの video。
- WP-CLIの確認コマンドと変更コマンドの区別(option・post・plugin・theme・eval-file・search-replace) WP-CLIは「見るだけ」のコマンド(get・list)と「変える」コマンド(update・delete・activate・search-replace本番・eval-file)がある。必ず確認コマンドで現在値を控えてから、バックアップを取り、変更は1つずつ。eval-fileはスクリプトの中身次第で書き込むので変更扱い。
- SSHの基本(接続先・ポート・鍵認証とパスワード認証・秘密鍵/公開鍵・known_hosts・configファイル) SSHはサーバーに暗号化した通信でコマンド接続する仕組み。接続にはホスト・ポート・ユーザー・認証方法が必要。鍵認証では秘密鍵を手元に、公開鍵をサーバーに置く。秘密鍵・パスワードはknowledgeやAIへの依頼文に書かない。
- JavaScriptコピペ集(DOMContentLoaded・querySelector・click・classList.toggle・スクロール・表示切替・accordion・tab)ライブラリなし HTML/CSSだけで済むもの(アコーディオンはdetails/summary、ページ内リンクはscroll-behavior)はJSを使わない。JSが必要なときは DOMContentLoaded 後に querySelector で要素を取り、click で classList.toggle する形が基本。要素がないページでエラーにならないよう存在確認する。
- curl・HTTP確認コピペ集(ステータス200確認・ヘッダー・robots.txt・HTML取得・リダイレクト確認・PowerShellのcurl注意) Windows PowerShell 5.1 では curl が Invoke-WebRequest の別名なので、本物の curl は curl.exe と書く。ステータスは curl.exe -s -o NUL -w "%{http_code}"、ヘッダーは -I、リダイレクトは -IL で追う。すべて読み取りだけ。
- HTMLコピペ集(section・container・見出し・カード・リンク/ボタン・画像/figure・リスト・表・電話/メール/外部リンク・iframe・YouTube・地図) よく使うHTMLの型。見出しは順番どおり(H1は1つ)、画像にはalt、移動はa・操作はbutton、外部リンクの別タブには rel="noopener"、iframeにはtitle。YouTube・地図の詳しい注意は各ナレッジ。
- ファイル検索コピペ集(PowerShellで文字列・CSSクラス・href="#"・URL・拡張子で探す、件数を数える) 下の階層まで探すのは Get-ChildItem -Recurse -Include と Select-String の組み合わせ。-SimpleMatch で記号をそのまま検索、-Encoding UTF8 で日本語を正しく読む。件数は Measure-Object。読み取りだけなので安全。
- CTAの構造コピペ集(お問い合わせ・電話・LINE・予約・購入・詳細を見る/主ボタンと副ボタン・補足・スマホ固定) CTAは「何をするか(見出し)→ 主ボタン1つ → 副ボタン → 補足(営業時間・所要時間・外部サイトへ移動)」の構造。行動の種類ごとにリンクの形(/contact/・tel:・LINE・外部予約・購入)を変え、GA4で計測できるようにする。文言は案件ごとに決める。
- CSSコピペ集(中央寄せ・flex・grid 2列/3列・gap・縦横中央・position・sticky・z-index・疑似要素・hover・表示切替) よく使うCSSの短いコード集。クラス名と数値は置き換えて使う。既存サイトに足すときは専用クラスに限定し、既存ルールを書き換えない(impl-css-priority)。説明は各ナレッジ、ここはコピペ用。
- レスポンシブの基本(viewport・max-width・メディアクエリ・clamp) viewport指定、コンテンツは max-width+左右padding、ブレークポイントは内容が崩れる幅で決める。文字サイズは clamp で滑らかに。確認は390px前後と768px・PC幅。
- PowerShellのファイル操作の基本(移動・一覧・読む・検索・存在確認・コピー・移動、削除は-WhatIfで確認) 読む・探す系(Set-Location・Get-ChildItem・Get-Content・Select-String・Test-Path)は安全。Copy-Item・Move-Itemは上書き・移動先を確認。Remove-Itemはごみ箱を通らず消えるので、-WhatIfで対象を確認してから、範囲を限定して使う。
- position・z-index・重なり順(スタッキングコンテキスト)と疑似要素の基本 z-index は position が static 以外の要素に効く。親が重なり順の箱(スタッキングコンテキスト)を作ると子の z-index はその中でしか比べられない。前に出したい要素だけに position:relative と z-index を付ける。
- OGPとシェア導線の設定(og:image・twitter:card・シェアボタン・キャッシュ) 各ページに og:title / og:description / og:image(絶対URL・1200×630目安)/ og:url / og:type を出す。SEOプラグインで出すなら二重出力に注意。シェア画像が古いときはSNS側のキャッシュを再取得する。
- CSS GridとFlexboxの使い分け、gapとmarginの使い分け 列と行をそろえる一覧はGrid、1方向に並べて中身の幅で配置するナビ・ボタン列はFlexbox。要素間の余白はgap、外側との距離はmargin/padding。
- HPに地図を載せる方法の使い分け(Google Mapsリンク・埋め込みiframe・地図画像・独自案内図) 通常のアクセス案内は「住所+Google Mapsへのリンク+埋め込みiframe1つ」で十分。駐車場・入口・分かりにくい道順は独自案内図を足す。埋め込みは横幅100%・スマホ高さ250〜350px前後・1ページ1つ・lazy。APIを使う高度な地図は別物(needs-review)。