Personal Knowledge マニュアル

Personal Knowledgeは、利用者本人や各サイトに固有の情報を、SIMS製品本体とは分離してGoogle Driveに保存するための個人用Knowledge領域です。

SIMSの製品版は全利用者で共通の1種類を使い、サイト情報・編集上の好み・運用Learningなどの個別差分だけをPersonal Knowledge側に保持します。

通常は利用者がJSONファイルを直接編集する必要はありません。Personal KnowledgeフォルダーをGoogle Driveに置いたまま、対応するSIMS機能から自動的に読み書きします。

Personal Knowledgeとは

Personal Knowledgeは、SIMS全体で共通するShared Knowledgeとは役割が異なります。

  • Shared Knowledge:すべての利用者に共通するContract、品質基準、編集Knowledge、製品間ルール
  • Personal Knowledge:利用者本人、個別サイト、複数サイト横断で蓄積する固有情報

この分離により、SIMS製品を利用者ごとに改造したり、個人情報を製品Repositoryへ埋め込んだりする必要がありません。

現在の保存場所

Personal KnowledgeはGoogle Drive上のSIMS-Personal-Knowledgeフォルダーを基点として管理します。

ルートには管理情報があり、その下をowner / sites / cross-site / systemに分けて保存します。

SIMS-Personal-Knowledge/
├─ MANIFEST.json
├─ README-FIRST.txt
├─ owner/
│  ├─ EDITORIAL_PREFERENCES.json
│  └─ LEARNING.json
├─ sites/
│  └─ SITE-.../
│     ├─ SITE_PROFILE.json
│     ├─ ARTICLE_KNOWLEDGE.json
│     ├─ CLUSTERS.json
│     └─ LEARNING.json
├─ cross-site/
│  └─ LEARNING.json
└─ system/
   └─ MIGRATION_HISTORY.json

各フォルダーの役割

owner

特定サイトではなく、利用者本人に属する継続情報を保存します。

  • EDITORIAL_PREFERENCES.json:編集・執筆上の個人設定や好み
  • LEARNING.json:利用者レベルで蓄積する運用Learning

sites

サイトごとのPersonal Knowledgeです。各サイトは内部のSITE IDで分離されるため、複数サイトの情報を混在させない設計です。

  • SITE_PROFILE.json:サイトの基本プロフィール
  • ARTICLE_KNOWLEDGE.json:記事単位で蓄積するKnowledge
  • CLUSTERS.json:サイト内のテーマ・記事クラスター情報
  • LEARNING.json:そのサイトで得られた運用Learning

cross-site

1つのサイトだけに限定されず、複数サイトの運用から得られた利用者固有の横断Learningを保存します。

system

Personal Knowledgeの移行履歴など、システム管理用の情報を保存します。通常の利用者が編集する場所ではありません。

普段の運用で何をすればよいか

基本的には何もしなくて大丈夫です。Personal Knowledgeフォルダーを削除・移動せず、そのままGoogle Driveに置いてください。

対応するSIMS製品が必要な情報を読み込み、Learningなどを自動更新します。通常運用でJSONファイルを開いて手入力することは前提にしていません。

SIMS製品を更新した場合

Personal Knowledgeは製品Repositoryや配布ZIPとは別に保存されるため、SIMS Manager、aDoctor、aWriter、aCreator、aMergeなどを更新しても、Personal Knowledgeを一緒に入れ替える必要はありません。

つまり、製品は共通版を更新し、個人データはPersonal Knowledgeとして残すという運用ができます。

バックアップするとき

Personal KnowledgeはGoogle Drive上の通常ファイルとして保存されています。バックアップが必要な場合は、SIMS-Personal-Knowledgeフォルダー全体をまとめてコピーしてください。

一部のJSONだけを個別にコピーするより、MANIFEST.json、owner、sites、cross-site、systemを含めたフォルダー全体を保持する方が安全です。

別環境へ移行するとき

Personal Knowledgeは手動移行にも対応する設計です。別のGoogle Drive環境などへ移す場合は、原則としてフォルダー構造を保ったまま全体を移します。

移行後に利用するSIMS製品がPersonal Knowledgeの保存先を正しく参照していることを確認してください。SITE IDを自己判断で変更したり、サイトフォルダー同士のJSONを混ぜたりしないでください。

Claudeへアップロードする必要はある?

Personal Knowledgeフォルダー全体をClaudeのShared Knowledgeとしてアップロードするものではありません。

Shared KnowledgeとPersonal Knowledgeは別物です。必要なPersonal Knowledgeは、対応するSIMSの処理が対象サイト・用途に応じて扱います。利用者がフォルダー全体をClaude Projectへ追加する通常運用は行いません。

製品Repositoryへ入れてはいけない

Personal Knowledgeには利用者・サイト固有の情報が含まれるため、GitHub用Repository ZIPや利用者配布用SIMSパッケージへ入れません。

製品本体とPersonal Knowledgeを分離することで、製品版を1つに保ち、利用者固有情報の誤配布も防ぎます。

Shared Knowledgeへ昇格する情報

Personal Knowledgeで得られたLearningのすべてがShared Knowledgeになるわけではありません。

特定サイトだけに有効な知見はPersonal Knowledgeに残します。複数案件で再現し、利用者を問わずSIMS全体で有効と確認できたルールだけを、製品側のレビューを経てShared Knowledgeへ反映します。

取り扱い上の注意

  • 通常はJSONファイルを手作業で編集しない
  • SIMS-Personal-Knowledgeフォルダーを製品Repositoryへコピーしない
  • 異なるサイトのSITE IDやJSONを混在させない
  • 移行・バックアップではフォルダー全体を扱う
  • Shared Knowledge用アップロードファイルとして使用しない
  • 削除前にはバックアップを確認する

よくある質問

Q. Personal KnowledgeはSIMSの製品ですか?

通常の操作画面を持つ独立アプリというより、SIMSが利用する利用者専用の永続Knowledge Storeです。

Q. 毎日Personal Knowledgeを開く必要がありますか?

ありません。通常はSIMSに任せます。

Q. SIMSを最新版へ更新するとPersonal Knowledgeは消えますか?

製品配布物とは別フォルダーなので、通常の製品更新で一緒に置き換えるものではありません。ただし、Google Drive上のPersonal Knowledgeフォルダー自体を削除しないようにしてください。

Q. 新しいPCへ移る場合は?

同じGoogle Driveを使用する場合は、Personal KnowledgeがDrive上に残っていることを確認します。別のDrive環境へ移す場合はSIMS-Personal-Knowledgeフォルダー全体を移行します。

Q. サイトを追加したら何をしますか?

対応するSIMSのサイト登録・設定処理を使用してください。sites配下のSITEフォルダーやSITE IDを手作業で複製することは推奨しません。

Q. 自分で覚えさせたい情報をJSONへ書き込んでもよいですか?

通常運用では推奨しません。SchemaやSITE IDとの整合性を壊す可能性があるため、対応するSIMSの登録・Learning機能を利用します。

Q. Personal Knowledgeを他の利用者へ配布できますか?

製品配布物として共有するものではありません。利用者・サイト固有情報を含む可能性があるため、共通配布するSIMS製品とは分離してください。

Personal Knowledgeの要点

利用者・サイト固有情報をGoogle Driveへ保存する
→ 製品本体から分離する
→ owner / sites / cross-site / systemで役割を分ける
→ 通常はSIMSが自動的に読み書きする
→ 製品更新時もPersonal Knowledgeはそのまま残す
→ バックアップ・移行はフォルダー全体で行う
→ Claude Shared KnowledgeやGitHub配布物へ混ぜない

関連ページ

SIMS全体の共通知識について確認する場合:

Shared Knowledge マニュアルへ →

各SIMS製品の使い方を確認する場合:

SIMS マニュアル・FAQへ →

SIMSを最初から確認する場合:

SIMSをはじめる →

simsをフォローする