ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「AI」の検索結果 96件(関連の高い上位50件を表示)
絞り込みを解除- AIに任せすぎてはいけない部分(公開判断・削除・設定変更・事実確認) 公開・検索公開・削除・上書き・プラグイン/設定変更・顧客向けの事実や料金はAIに判断させない。AIは準備・実行・検査まで、判断と承認は人が行う。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- HP制作でのAIの役割分担(チャット型AIとClaude Codeの使い分け) 相談・文章・部分的なコードはチャット型AI、ファイル一括処理・コマンド・検査の自動化はClaude Codeのようなエージェント型。具体的な機能・料金・モデル差は変わるので都度確認する。
- AIで大量ページを作るときの品質管理(小さく試す・テンプレート固定・自動検証・抜き取り確認) 最初は3ページで人が確認→テンプレート固定で中身だけAIに書かせる→文字数・禁止タグ・類似度・リンクを自動検証→1カテゴリ終わるごとに公開後検査。数合わせの水増しは禁止。
- サイトから送るメールの設定(SMTP送信・SPF/DKIM/DMARC・Gmail送信者ガイドライン・メルマガのルール) WordPressのメールはSMTPプラグインで自ドメインのメールサーバーから送り、Fromは自ドメインにする。DNSにSPF・DKIM・DMARCを設定し、Gmailのヘッダーで3つともPASSを確認する。
- AIで表示速度を改善するときの任せ方(調査・一覧化・改善案はAI、本番変更の判断は人) HTML/CSS/JSの確認、重そうな要素・画像・外部スクリプトの一覧化、改善案、変更前後の比較はAIに任せやすい。本番への大量変更、プラグイン削除、キャッシュ・CDN・サーバー設定、本番JSの一括最適化はAIだけで判断しない。必ずバックアップと検証を伴う。
- AIでサイト検査を自動化する考え方(サーバー側差分・HTTP・実ブラウザの3層) AIに検査スクリプトを書かせ、①サーバー側でバックアップとの差分、②HTTP・H1・href="#"、③ヘッドレスChromeでPC/390pxの実クリック・横スクロール・スクショを機械的に判定する。AIの目視判定に頼らない。
- AIツールの最新仕様メモ(モデル名・料金・機能制限は確認日付きで管理) 変わりやすいAIの仕様を置く場所。現時点では確認済みの内容はなく、使う前に公式情報を確認し、確認日付きで表に追記する。
- 画像生成AIへの指示の作り方(用途・サイズ・構図・位置関係・禁止要素) 用途と書き出しサイズ、構図、入れる要素と位置、色、入れてはいけないものを分けて指示する。正確な位置関係・文字・地図・番号はAIが崩しやすいので、ベース画像を人が作るか後から編集ソフトで入れる。
- 最新確認が必要なAI知識と、長く使えるAI知識の区別 モデル名・料金・上限・UI・使えるツールは変わるので needs-review で確認日付き管理。指示の出し方・検査の仕方・任せる範囲などの使い方は長く使える知識として残す。
- AIにファイル操作をさせるときの安全度(読む・検索・新規作成は安全、上書き・移動・一括置換は注意、削除・大量変更・本番置換は危険) 読む・検索・新規ファイル作成・別名保存は安全度が高い。上書き・移動・一括置換は変更前の控えと差分確認が必要。削除・大量変更・本番ファイルの置換は危険度が高く、バックアップ・対象一覧・人の確認を必ず伴う。
- AIにHTML/CSS修正を頼むときの安全な指示(指定箇所以外を変更させない) 変更範囲・変えてよい値・禁止事項を明示し、新しいCSSは専用クラスに限定、作業後は変更前との差分とスクショで「指定箇所以外が変わっていない」ことを機械的に確認させる。
- AIへの作業依頼の型(目的・対象・禁止事項・検査・報告形式) 目的・対象・現状・やること・禁止事項・検査・止める条件・報告形式を分けて書く。guidepocket.net 制作で繰り返し使い、手戻りが少なかった指示の型。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- AIでのHTML修正:完全HTMLで渡す場合と差分修正の使い分け 既存ページの修正は差分(該当箇所だけ置換・追記)が基本。新規ページはテンプレートのプレースホルダ置換で作る。完全HTMLの再出力は、小さいHTMLの新規作成か全面作り直しのときだけ。
- 指定した箇所だけAIに修正してもらう HTML・CSS・文章の一部だけを直してほしいとき。範囲を具体名で伝え、差分で「指定箇所以外0」を確かめる。
- AIでスマホ表示を改善する流れ(現状把握→方針→最小修正→390px実機確認) スクショと数値(高さ・横スクロール・折り返し)で現状を把握させ、スマホ専用のメディアクエリ内だけで最小修正し、390px幅で実表示を確認させる。PCは変えない。
- AIでコードレビューする方法(観点を指定し、指摘は実機で確かめる) 観点(動作、表示崩れ、アクセシビリティ、既存との一貫性)と「指摘だけで修正しない」を指定する。指摘は重大度順に出させ、正しいかは実機・DevToolsで確かめてから直す。
- HTMLコピペ集(section・container・見出し・カード・リンク/ボタン・画像/figure・リスト・表・電話/メール/外部リンク・iframe・YouTube・地図) よく使うHTMLの型。見出しは順番どおり(H1は1つ)、画像にはalt、移動はa・操作はbutton、外部リンクの別タブには rel="noopener"、iframeにはtitle。YouTube・地図の詳しい注意は各ナレッジ。
- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- GA4のイベント・キーイベント(コンバージョン)とUTMパラメータの付け方 自動計測で足りないCV(フォーム送信・電話タップ・購入ボタン)はGTMでイベントを作り、GA4でキーイベントに指定する。UTMは source/medium/campaign を小文字の命名ルールで統一する。
- 自動化するか手作業にするかの判断(繰り返し・定型・大量・検査は自動化向き、一度きり・判断が多い・仕様が揺れるものは手作業) 繰り返し・定型・大量・チェック・変換・一覧化・バックアップ・検査は自動化向き。一度しかやらない、判断が多い、仕様が頻繁に変わる、自動化を作る方が時間がかかるものは手作業かAIとの対話で。何でも自動化すればよいわけではない。
- 「他は変更しない」指示の定型文(指定箇所だけ変更・追加のみ・調査のみ) AIが「ついでに整える」のを防ぐ定型文を3種類(指定箇所だけ変更/追加だけ/調査だけ)。変えてよい範囲を具体名で書き、他に必要な変更は「実施せず報告」させ、差分で確認する。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- JavaScriptコピペ集(DOMContentLoaded・querySelector・click・classList.toggle・スクロール・表示切替・accordion・tab)ライブラリなし HTML/CSSだけで済むもの(アコーディオンはdetails/summary、ページ内リンクはscroll-behavior)はJSを使わない。JSが必要なときは DOMContentLoaded 後に querySelector で要素を取り、click で classList.toggle する形が基本。要素がないページでエラーにならないよう存在確認する。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- 大量のページを少しずつ作る(3件テスト→カテゴリ単位) 数十〜数百ページをAIで作るとき。構成表とテンプレートを先に固め、3件だけ作って人が確認し、1カテゴリずつ生成・下書き・検査・公開する。
- メールの仕組みとDNS(MX・SPF・DKIM・DMARC・SMTP・IMAP・POP)と「Webだけ移転」で止まるメール事故 メールの受信先はMX、送信の正当性はSPF・DKIM・DMARC(TXT)で決まり、Webの行き先(A)とは別。サーバー移転でネームサーバーごと変えると、新DNSにMX・TXTがなくメールが止まる。「Webだけ移転」ならAだけ変え、「メールも移転」はメールボックスの移行と切替日を別に計画する。
- Claude Code が作業前にナレッジを検索・追加する手順 作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。
- Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ) Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
- WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない) 「送信処理が失敗している」か「送れているが受信側で弾かれる」かを分ける。SMTPプラグインのテストメールとメールログで確認し、From・Reply-Toの設定、SPF/DKIM、受信側の迷惑メールを順に見る。
- SSHの基本(接続先・ポート・鍵認証とパスワード認証・秘密鍵/公開鍵・known_hosts・configファイル) SSHはサーバーに暗号化した通信でコマンド接続する仕組み。接続にはホスト・ポート・ユーザー・認証方法が必要。鍵認証では秘密鍵を手元に、公開鍵をサーバーに置く。秘密鍵・パスワードはknowledgeやAIへの依頼文に書かない。
- ドメイン管理会社・サーバー会社・ネームサーバーの役割と「ドメイン移管」「サーバー移転」「URL変更」の違い ドメイン移管=ドメインの契約先(管理会社)を変える。サーバー移転=サイトのファイル・DBを別サーバーへ移す。URL変更=サイトのアドレス自体を変える。3つは別作業で、影響範囲(Web・メール・SSL・検索)が違う。
- 確定事項の優先順位(最終・採用 > 案・試行、新しい明示指示が最優先) 最終・採用・確定・変更禁止の情報を途中案より優先する。古い確定事項と新しい明示指示が矛盾したら新しい指示を優先する。
- ページ単位のSEO基本(title・description・見出し・内部リンク・やってはいけないこと) 1ページごとに確認するSEOの基本項目と、順位を落とす・手動対策の対象になる行為。robots・noindex・canonical・サイトマップの確認方法は ops-search-visibility-check に分けている。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- WordPress操作に Claude in Chrome(Chrome拡張)は使わない guidepocket.net の作成・公開・検査は SSH / WP-CLI で行う。Chrome拡張の接続を待ったり、認証情報を探したり、別の危険な方法を試したりしない。
- 本番・ステージング・ローカル・テストサイトの使い分け(大きな変更はいきなり本番でしない) テーマ変更・PHP更新・大型プラグイン導入・構成変更はステージングで試してから本番へ。小さな限定変更は「バックアップ+限定変更+検証」で十分なこともある。テスト環境は必ず非公開(noindex・認証)にし、本番とデータを取り違えない。
- サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ) 小カテゴリ1つ(8記事)ごとにサブエージェントを1つ立て、共通ブリーフで原稿を書かせる。戻り値はファイルパスとH2一覧だけにして本文を返させない。文字数は len.ps1 で確認する。
- Claude CodeのAuto modeの考え方(自動で進む操作・確認が出る操作・確認画面で見るべき点) Auto modeはローカルの読み取り・検索・新規ファイル作成など安全な操作を自動で進め、削除・上書き・本番サーバー書き込み・外部サービスへの送信などは確認や停止になることがある。確認が出たのは失敗ではない。削除・本番変更・認証情報・大量上書きの確認は内容を読んでから許可する。
- ナレッジを追加・更新してサイトへ同期する 作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
- Claude Codeで作業を始める・再開する 新しい作業の始め方と、前回の続き・途中で止まった後の再開のしかた。まず調査だけさせて状態を確かめてから続ける。
- WordPressのURL変更・ドメイン変更(サイトアドレス・DB内URL・シリアライズ・301・canonical・Search Console・GA4・メール) WordPressアドレス・サイトアドレスを変え、DB内の旧URLは wp search-replace(dry-run→本番)で置換、旧URLから新URLへページ単位で301。SQLの単純置換はシリアライズデータを壊す。Search Console・GA4・外部サービス・メールアドレスの変更も忘れない。
- Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意) サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
- auto mode の安全チェックでサーバー書き込みが止められたときの対応 サーバーへの書き込みコマンドが auto mode に止められたら、分割や別手段で回避しない。止められた内容を報告し、/permissions での許可か通常の確認画面を待つ。
- Gitの基本(repository・commit・branch・status・diff・log・add・push・pull・clone)とGitHubとの違い Gitは手元のフォルダの変更履歴を記録するツール。GitHubはGitのリポジトリを置いて共有するWebサービスで、Git=GitHubではない。status→diff→add→commit が基本の流れ、push/pull で共有先と同期する。
- Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要) PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
- 作業の再開方法(途中停止・API Error・コンテキスト切れのあと) 再開時はまず現状を調べるだけにし、完了・途中・未着手・最後に成功した処理・止まっている処理を報告してから続ける。同じページを重複作成しない。