ナレッジを追加・更新してサイトへ同期する
要点
作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
使う場面
- 作業で解決したこと・何度も使う手順を残したいとき
- 既存ナレッジの内容が古くなったとき
- 「よく使う流れ」を入れ替える・直すとき
最初に確認
- 同じ内容のナレッジが既にないか(あれば新規にせず、そのファイルを更新する)
- 本当に残す価値があるか(また使う/検索して見つからなかった/トラブル解決に役立った)
- 接続先・ユーザー名・鍵・パスワード・APIキーを書いていないか(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)
手順
- 既存を検索する。
- 更新するか、テンプレートから新規作成する(
templates/、tools\new.ps1)。再利用できる知識は分野のフォルダ、案件固有だけprojects/。 build-index.ps1→check.ps1(エラー0)。- 必要なら、想定する検索語で1位に出るか確認。
- guidepocket.net へ差分同期: 書き出し → アップロード → DRY → 本番 → もう一度 DRY(unchanged だけになる)。
- 変えたページだけ表示確認(200・H1・390px)。
Claude / AIへ送る指示
今回の作業で分かったことを knowledge/ に残してください。
- まず search.ps1 で既存を検索し、同じ内容があれば新規にせずそのファイルを更新してください。
- 再利用できる知識は分野のフォルダへ、案件固有の情報だけ projects/ へ。
- 接続情報・パスワード・鍵・APIキーは書かないでください。
- build-index.ps1 → check.ps1 を実行し、エラー0を確認してください。
- guidepocket.net へは差分同期(DRY → 本番 → 再DRY)で、変更したものだけ反映してください。全件の再同期・全件監査はしないでください。
コマンド
【ローカル】 検索・作成・索引・チェック(プロジェクトのフォルダで。サイトは変わらない):
powershell -NoProfile -File .\knowledge\tools\search.ps1 "〔内容〕 〔ツール〕"
powershell -NoProfile -File .\knowledge\tools\new.ps1 -Type 〔種類〕 -Id 〔id〕 -Title "〔タイトル〕" -Area 〔分野〕
powershell -NoProfile -File .\knowledge\tools\build-index.ps1
powershell -NoProfile -File .\knowledge\tools\check.ps1
【ローカル】 同期用ファイルの書き出し:
powershell -NoProfile -File .\knowledge\tools\guidepocket-scripts\gpkb\gpkb_export.ps1 -Kb .\knowledge -All -Out .\bundle.json
【読み取り】 アップロードして DRY(サーバー。WordPressのフォルダで。書き込みなし):
scp bundle.json 〔接続名〕:~/wg-upload/gpkb/bundle.json
DRY=1 wp eval-file ~/wg-upload/gpkb/gpkb_sync.php --skip-plugins --skip-themes
【変更あり】 本番の同期(DRY で new / updated が想定どおり・error 0 を確かめてから。終わったら上の DRY をもう一度実行し unchanged だけになるか確認):
STATUS=publish wp eval-file ~/wg-upload/gpkb/gpkb_sync.php --skip-plugins --skip-themes
最後の確認
check.ps1がエラー0- 本番後の DRY が unchanged だけ(不要な更新なし)
- 変えたページが 200・H1 1つ・390pxで崩れなし
注意点
- orphaned(knowledge にない投稿)・excluded は報告だけ。削除・非公開は人が判断する。
- 同期の取り消しは同期前スナップショットから(
gpkb_restore.php、先に DRY=1)。 - PowerShell 5.1 で動かすスクリプトは BOM付き UTF-8 で保存する(Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要))。
- 設計と全体の手順は
knowledge/projects/guidepocket.net/kb-wordpress-design.md(サイトには出さない案件ファイル)。