ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
状態: 確定 32件
絞り込みを解除- Astraでカスタム投稿の一覧・独自検索が10件に切られる(posts_per_page が上書きされる) Astra は parse_tax_query で、すべてのアーカイブ(カスタム投稿タイプの一覧も含む)の posts_per_page を「ブログの表示件数」(既定10)に上書きする。pre_get_posts で30件・100件にしても10件になり、独自の並べ替え検索では更新順の先頭10件だけが採点される。対策は astra_blog_post_per_page_exclusions フィルターに投稿タイプを追加して除外する(テーマ・設定は変えない)。
- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- 公開後検査(公開後チェック)の項目と方法(HTTP・H1・href="#"・実クリック・スマホ390px・横スクロール・既存差分) 公開後チェック。新規・変更ページに対して、サーバー側verify、HTTP/H1/プレースホルダ/href="#"、PC・スマホ390pxの実クリック、横スクロール、既存ページ差分を確認する。全体監査は節目だけ。
- バックアップ方針(作業前に必ず取り、削除しない) WordPressへ書き込む作業の前に毎回新しいバックアップを取る。名前は wg-backup-YYYYMMDD-<作業名>。古いバックアップは削除しない。設定を変えるときは変更前の値をファイルに残す。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- auto mode の安全チェックでサーバー書き込みが止められたときの対応 サーバーへの書き込みコマンドが auto mode に止められたら、分割や別手段で回避しない。止められた内容を報告し、/permissions での許可か通常の確認画面を待つ。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- AIに任せすぎてはいけない部分(公開判断・削除・設定変更・事実確認) 公開・検索公開・削除・上書き・プラグイン/設定変更・顧客向けの事実や料金はAIに判断させない。AIは準備・実行・検査まで、判断と承認は人が行う。
- よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH) 作業フォルダへの移動、UTF-8表示、Claude Code起動、knowledge検索/索引/チェック、WP-CLIとSSHの読み取り専用確認、バックアップ→変更→検査の骨組み。秘密情報は書かない。
- guidepocket.net 制作ルール(CLAUDE.md・ページ作成ルール・文章ルールの要点) CLAUDE.md の最優先ルールと、その後のユーザー指示で固まった制作ルール(本文字数、戻るリンク仕様、H1、href="#"禁止など)の要点。
- 既存ページ保護ルール(指定箇所以外は触らない) 指定された箇所以外は変更しない。完成済みページを正式な基準にし、変更は必要最小限。作業後はバックアップとの差分で確認する。
- Elementorのキット・テンプレート等の内部データは触らない 使用中のElementorキット(guidepocket.net は ID 1659)は削除・非公開・編集しない。内部データが検索やサイトマップに出る場合は外側の設定で対処する。
- 確定事項の優先順位(最終・採用 > 案・試行、新しい明示指示が最優先) 最終・採用・確定・変更禁止の情報を途中案より優先する。古い確定事項と新しい明示指示が矛盾したら新しい指示を優先する。
- テスト用に注入したCSSが本番CSSより先に読み込まれて効かない ブラウザ検査で仮のCSSを注入したら、ページ内の本番CSSより前に入って上書きされず効かなかった。本番では<style>末尾に追記するので問題なし。テスト時は後ろに入れるか詳細度を上げる。
- ローカルのテンプレートCSSが公開中ページと一致しない(フル版CSSを正式採用) 手元のテンプレートは簡略版で、公開中ページのCSSと食い違っていた。公開中の多数派3ページ(2482・2519・2572)の共通CSSを正式基準にし、テンプレートと生成済み記事を合わせた。
- Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要) PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
- プロジェクトのファイル名が文字化けしている(UTF-8をCP932として解釈) スターターの一部ファイル名がUTF-8バイトをCP932で解釈した化け名のまま実在する。表示崩れではなく実名。サイズ条件などで特定して扱う。
- 親の固定ページが下書きだと子ページのURLが404になる 下書きの親はスラッグが確定しないため、公開した子のURLから親階層が抜けて404になる。親を公開すればスラッグが決まり解消。先に親を公開してから子を作る。
- リンク・ボタンがクリックできない(見えない要素の重なり・pointer-events・z-index) 最も多いのは透明な要素(ヘッダー、疑似要素、広がった余白)がリンクの上に重なっているケース。elementFromPoint で一番上の要素を特定し、リンク側に position:relative と z-index を足すか、重なる側に pointer-events:none を付ける。
- 実クリック検査でページ下部のリンクだけ失敗する(scrollIntoViewが効かない) body{overflow-x:hidden} のページでは scrollIntoView が期待どおり動かず、下段リンクのクリックが検査側で失敗する。scrollTo({behavior:'instant'}) で位置を指定してからクリックする。
- 作業の再開方法(途中停止・API Error・コンテキスト切れのあと) 再開時はまず現状を調べるだけにし、完了・途中・未着手・最後に成功した処理・止まっている処理を報告してから続ける。同じページを重複作成しない。
- WordPress操作に Claude in Chrome(Chrome拡張)は使わない guidepocket.net の作成・公開・検査は SSH / WP-CLI で行う。Chrome拡張の接続を待ったり、認証情報を探したり、別の危険な方法を試したりしない。
- Claude Code が作業前にナレッジを検索・追加する手順 作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。
- AIでサイト検査を自動化する考え方(サーバー側差分・HTTP・実ブラウザの3層) AIに検査スクリプトを書かせ、①サーバー側でバックアップとの差分、②HTTP・H1・href="#"、③ヘッドレスChromeでPC/390pxの実クリック・横スクロール・スクショを機械的に判定する。AIの目視判定に頼らない。
- WEBガイドのデザインルール(白ベース・最大幅1080px・文字サイズ) 白ベースに黒・濃いグレー。最大幅1080px、PC余白48px・スマホ28px。H1/H2/本文のサイズ、黒背景のまとめ、スマホは1列。記事ごとにデザインを変えない。
- WordPressの日本語スラッグと -2 衝突、URLの取り方 スラッグはWordPress標準のタイトル由来(sanitize_title)。英字は小文字、ドットはハイフン等に変わる。-2 が付いたら勝手に決めず確認。URLは推測せず get_permalink で取る。
- WordPress固定ページ制作の基本(親子階層・並び順・公開順・ページIDとURLの確認) 階層は親(post_parent)で作り、並び順は menu_order で決める。親を先に公開してから子を作り、URLは get_permalink で取る。同名・同スラッグは下書き・ゴミ箱も含めて事前確認する。
- WEBガイドのテンプレートと記事本文HTMLのルール(HTML①・HTML②) 個別記事テンプレートのプレースホルダ、使ってよい本文要素、原稿ファイルの形式。カテゴリページは公開中の2566(親は2460)のHTMLを基準にする。
- Elementor HTMLウィジェット2つで作る固定ページの構造とメタ(WP-CLIで再現) 1コンテナ+HTMLウィジェット3個(HTML①・HTML②・空)。_elementor_data と Astra/Elementor のメタを手本ページから複製して作る。REST APIでは保護メタを書けないのでWP-CLIを使う。