ナレッジを追加・更新してサイトへ同期する

よく使う流れ 採用 AI活用公開・保守・運用 更新 2026-09-29
要点

作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。

使う場面

  • 作業で解決したこと・何度も使う手順を残したいとき
  • 既存ナレッジの内容が古くなったとき
  • 「よく使う流れ」を入れ替える・直すとき

最初に確認

手順

  1. 既存を検索する。
  2. 更新するか、テンプレートから新規作成する(templates/、tools\new.ps1)。再利用できる知識は分野のフォルダ、案件固有だけ projects/。
  3. build-index.ps1 → check.ps1(エラー0)。
  4. 必要なら、想定する検索語で1位に出るか確認。
  5. guidepocket.net へ差分同期: 書き出し → アップロード → DRY → 本番 → もう一度 DRY(unchanged だけになる)。
  6. 変えたページだけ表示確認(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(サイトには出さない案件ファイル)。