ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
重要 56件
絞り込みを解除- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- 既存ページ保護ルール(指定箇所以外は触らない) 指定された箇所以外は変更しない。完成済みページを正式な基準にし、変更は必要最小限。作業後はバックアップとの差分で確認する。
- Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ) Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
- WordPressのプラグイン・テーマ・本体・PHP更新の安全な手順(事前確認→バックアップ→1つずつ更新→確認→戻し方) 更新は止めない(脆弱性の多くは古いプラグイン)が、まとめて一気にやらない。バックアップ→更新内容の確認→1つずつ更新→表示・フォーム・管理画面を確認。本体のメジャー更新とPHP版の変更は別の日に。壊れたら直前に更新したものを止めて戻す。
- お問い合わせフォームのスパム対策(ハニーポット・reCAPTCHA・Turnstile・送信テスト・誤判定) まずプラグイン標準のハニーポット(見えない入力欄)を有効にし、それで足りなければ reCAPTCHA v3 か Cloudflare Turnstile を追加。導入後は必ずPC・スマホで実際に送信テストする(誤判定で正規の問い合わせが消えるのが一番の事故)。人が送る営業メールは完全には防げない。
- 公開前チェックリスト(バックアップ・URL・H1・PC/スマホ・横スクロール・リンク・フォーム・電話・メール・画像・404・noindex/index・計測・キャッシュ) 公開前に確認する短いチェックリスト。すべての案件で全項目必須ではなく、作業内容に合わせて選ぶ。noindex/index は案件の方針どおりか確認する(guidepocket.net は noindex 維持)。
- WordPressセキュリティの基本(更新・不要プラグイン削除・パスワード・2FA・権限・WAF・ログ・ログイン試行・脆弱性) 被害の多くは古いプラグイン・テーマの脆弱性と弱いパスワード。更新・不要なものの削除・強いパスワード+2FA・最小限の管理者・WAF・ログ確認・バックアップを組み合わせる。セキュリティプラグインを入れれば終わりではない。
- WEB画像の形式とサイズの選び方(WebP・JPEG・透過PNG・SVG・比率・書き出しサイズ) 写真はWebP(またはJPEG)、透過が必要なロゴ・切り抜きはPNGかWebP、アイコン・図形はSVG。書き出しは表示サイズの1〜2倍、比率は用途ごとに統一する。速度面では実表示より極端に大きくしない・lazy(メイン画像以外)・width/heightでCLS防止。AVIFは対応状況を要確認。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- 外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由 外部サービスはリンク・iframe・script埋め込み・ウィジェット・APIの順に手軽→自由度高。iframeの中身は別サイトなので自サイトのCSSでは変えられない(枠の大きさだけ)。埋め込みは速度・Cookie・停止時の表示・高さ変化に注意。
- WordPressサイトのサーバー移転の流れ(旧環境確認→バックアップ→移行→事前確認→DNS切替→SSL→メール→検査→旧サーバーは残す) サーバー移転は、旧環境(DNS全レコード・メール・PHP版・プラグイン)を控え、フルバックアップ後に新サーバーへファイルとDBを移し、hostsで事前確認してからDNSを切り替える。SSL・メール・HTTP・フォーム・画像・リンクを確認し、旧サーバーはすぐ解約しない。
- 安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認) 戻せる状態を作ってから変える。バックアップ→書き込みなしの試し実行→本番→差分検証→表示検査。普段は変更部分だけ検査し、全件検査は大きな節目だけ。
- 公開後検査(公開後チェック)の項目と方法(HTTP・H1・href="#"・実クリック・スマホ390px・横スクロール・既存差分) 公開後チェック。新規・変更ページに対して、サーバー側verify、HTTP/H1/プレースホルダ/href="#"、PC・スマホ390pxの実クリック、横スクロール、既存ページ差分を確認する。全体監査は節目だけ。
- 速度改善の実務手順(遅いページ特定→原因確認→1つずつ修正→再測定→PC/スマホ実動作確認) 遅いページを特定し、原因候補を画像→外部埋め込み→CSS/JS→プラグイン→キャッシュ→サーバーの順に確認。バックアップを取って1つずつ直し、再測定とPC/スマホの実動作確認をする。いきなり設定を大量に変えない。
- 障害対応の基本(いきなり直さず症状を切り分ける14の確認順) 何が・いつから・全員か一部か・端末・回線を確認してから、DNS→サーバー→WordPress→プラグイン→外部サービス→ログ→直前変更の順に原因を絞る。修正はバックアップを確認してから1つずつ。
- Gitの安全な使い方(commit前にstatus/diff・秘密情報をcommitしない・.gitignore・消しても履歴に残る) commit前に git status と git diff で対象と中身を確認し、git add . をむやみに使わない。.env・wp-config.php・鍵・APIキーは .gitignore で除外する。一度commitした秘密情報は、後で消しても履歴・コピー先に残るので、まずその認証情報を無効化・変更する。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- バックアップ方針(作業前に必ず取り、削除しない) WordPressへ書き込む作業の前に毎回新しいバックアップを取る。名前は wg-backup-YYYYMMDD-<作業名>。古いバックアップは削除しない。設定を変えるときは変更前の値をファイルに残す。
- WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ) まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
- スマホで横スクロールが出る(はみ出し要素の探し方と直し方) scrollWidth と clientWidth の差で横スクロールを判定し、右端をはみ出す要素をコンソールで探す。原因は固定幅・100vw・長い英数字・負のmargin・1frのグリッドなど。overflow-x:hidden で隠すのは最後の手段。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- 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、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- HP制作でのAIの役割分担(チャット型AIとClaude Codeの使い分け) 相談・文章・部分的なコードはチャット型AI、ファイル一括処理・コマンド・検査の自動化はClaude Codeのようなエージェント型。具体的な機能・料金・モデル差は変わるので都度確認する。
- AIに任せすぎてはいけない部分(公開判断・削除・設定変更・事実確認) 公開・検索公開・削除・上書き・プラグイン/設定変更・顧客向けの事実や料金はAIに判断させない。AIは準備・実行・検査まで、判断と承認は人が行う。
- WP-CLIの確認コマンドと変更コマンドの区別(option・post・plugin・theme・eval-file・search-replace) WP-CLIは「見るだけ」のコマンド(get・list)と「変える」コマンド(update・delete・activate・search-replace本番・eval-file)がある。必ず確認コマンドで現在値を控えてから、バックアップを取り、変更は1つずつ。eval-fileはスクリプトの中身次第で書き込むので変更扱い。