Shared Knowledge マニュアル

Shared Knowledgeは、SIMS全体で共通して使う編集知識・Contract・Enum・Validation・品質基準・製品間の役割分担を管理する「共通知識の正本」です。

SIMS Manager、aDoctor、aWriter、aCreator、aMergeなどが別々のルールで動かないように、SIMS全体の共通言語と安全基準を支えます。通常の利用者がShared Knowledgeを直接操作して記事を作る製品ではありません。

本マニュアルはShared Knowledge v3.6.0を基準にしています。

Shared Knowledgeとは

Shared Knowledgeは、記事を書くaWriterや診断するaDoctorのような実行製品ではなく、SIMS製品が共通して参照するKnowledge and Contract Planeです。

利用者向けの製品名は現在のSIMS体系へ統一されています。一方、保存済みデータ、JSON Contract、関数名、Schemaなどの内部識別子には互換性のため旧名称が残る場合があります。内部識別子は利用者向け名称とは別に扱います。

SIMS全体での位置

  • SIMS Manager:案件管理、Routing、処置結果登録、経過観察の中心
  • aDoctor:記事単位の精密診断、原因仮説、処置方針の提示
  • aWriter:既存記事の改善
  • aCreator:新記事の作成
  • aMerge:複数記事の統合と役割整理
  • Site Collector:サイト診断用Evidenceの収集
  • Site Doctor:サイト全体の診断
  • Keyword Explorer:新しいキーワード候補の探索
  • Blue Ocean Screener:キーワード候補の競争・SERP・新規記事適性の精査
  • Shared Knowledge:共通Contract、Enum、編集Knowledge、Validation、Governanceの正本
  • Personal Knowledge:利用者・サイト固有の継続的な知識を保存する領域

1. 通常の利用者はShared Knowledgeを直接操作しない

日々のブログ運用でShared Knowledgeを開いて処理する必要はありません。各SIMS製品には、その製品に必要なShared Knowledgeの範囲がProduct-scoped Snapshotとして組み込まれます。

利用者は、各製品の正式な配布パッケージと更新手順を使えば十分です。Shared Knowledge Repositoryから個別ファイルを選び、自己判断でClaude Projectへ追加する運用は基本的に行いません。

2. Shared Knowledgeが管理しているもの

共通Contract

製品間で受け渡す診断依頼、診断結果、処置依頼、処置結果などのデータ構造を定義します。各製品が独自形式へ勝手に変わることを防ぎます。

共通Enum

案件状態、診断コード、優先度、処置種別、Result Status、Routing Validationなど、複数製品で共通利用する値を管理します。

編集Knowledge

検索意図、Evidence、情報鮮度、内部リンク、FAQ、タイトル、数値整合性、YMYL安全性、自然な日本語など、記事品質に関わる横断的な知識を管理します。

Validation

公開前品質、Evidence整合性、自然な日本語、SEO上重要な誤り、Contract整合性などを検査する共通ルールを管理します。

Presentation

内部のMachine Contractは厳密に維持しながら、利用者には「次に何をすればよいか」が分かる表示へ変換するための共通方針を管理します。

Operational Learning

実運用で得られた知見を、記事・サイト固有の情報と、SIMS全体へ共通化できる改善候補に分けます。十分に検証された共通知識だけをShared Knowledge側へ昇格させる考え方です。

3. Shared Snapshotとは

Shared Knowledge全体には、複数製品向けのContractやルールが含まれます。すべてを各Claude Projectへ入れるのではなく、製品ごとに必要な範囲だけを切り出したものがShared Snapshotです。

たとえばaWriterには既存記事改善に必要なKnowledgeとContract、aCreatorには新記事作成に必要なKnowledgeとContractというように、製品の責任範囲に合わせてSnapshotを使います。

旧版と新版のSnapshotを同じProjectへ混在させると、同じ概念に複数のルールが存在する状態になる可能性があります。製品を更新するときは、その製品の正式パッケージに従って一式を入れ替えることが基本です。

4. SIMS Managerが運用の中心になる

Shared Knowledgeでは、記事単位の通常運用における案件管理・Routing・処置結果・経過観察の中心をSIMS Managerとして扱います。

通常の既存記事改善は、SIMS Manager → aWriter → SIMS Manager → 経過観察です。すべての記事をaDoctorへ送るわけではありません。

精密診断が必要な場合は、SIMS Manager → aDoctor → SIMS Manager → aWriter / aMerge / aCreator / 経過観察などの順に進みます。aDoctorは診断を担当し、処置そのものは専門製品へ分離します。

5. 製品ごとの役割を越えない

Shared Knowledgeの重要な役割の1つが、製品境界を守ることです。

  • aDoctorは診断を行い、記事本文を完成させる役割ではありません。
  • aWriterは既存記事を改善し、新規記事作成を主目的にしません。
  • aCreatorは新規記事を作成し、既存記事の通常改善を担当しません。
  • aMergeは統合案件を扱い、通常の軽微修正を担当しません。
  • Site Doctorはサイト全体を診断し、記事単位の精密診断は必要に応じてaDoctorへ渡します。
  • Keyword Explorerは候補発見、Blue Ocean Screenerは候補精査を担当します。

6. Shared KnowledgeとPersonal Knowledgeの違い

Shared Knowledgeは、すべての利用者・サイトで共通利用できる製品知識です。これに対してPersonal Knowledgeは、利用者自身や各サイトに固有の情報を保存する領域です。

  • Shared Knowledge:製品共通。Contract、品質基準、役割分担、共通編集知識など。
  • Personal Knowledge:利用者固有。編集上の好み、サイト固有情報、運用Learningなど。

利用者固有の情報をShared Knowledgeへ混ぜないことで、配布するSIMS製品を1つに保ちながら、個人環境だけを分離して管理できます。

7. Personal Knowledgeは製品配布物に含めない

Personal KnowledgeはGoogle Drive上の利用者専用領域として管理され、通常の製品Repositoryや配布ZIPには含めません。SIMS製品を更新しても、利用者固有の知識を製品ファイルへ直接埋め込まない設計です。

これにより、製品版は共通の1種類として維持し、利用者ごとの差分はPersonal Knowledge側で保持できます。

8. Shared Knowledgeを更新するとき

Shared Knowledge Repositoryだけを更新して、各Claude Projectへ手作業で一斉反映する必要はありません。各製品で対応Snapshotを組み込んだ正式版が用意された段階で、その製品を更新します。

Shared Knowledgeのバージョンと各製品のバージョンは別管理です。番号が一致していなくても異常ではありません。

よくある質問

Q. Shared Knowledgeを毎日の運用で開く必要がありますか?

通常は必要ありません。各SIMS製品に必要なSnapshotが組み込まれています。

Q. Shared Knowledge v3.6.0をaWriterへ全部アップロードすれば最新版になりますか?

推奨しません。aWriter用にReleaseされたSnapshotと製品Instructionsの組み合わせを使用してください。Shared Knowledge全体を追加すると、他製品向けのContractや不要な知識が混在する可能性があります。

Q. aDoctorの結果は、そのままaWriterへ渡しますか?

精密診断ルートでは、原則として一度SIMS Managerへ診断結果を登録し、SIMS Managerが次の処置へRoutingします。

Q. Shared Knowledgeのバージョンと製品のバージョンが違います。

正常です。製品VERSIONとShared Knowledge VERSIONは別に管理されています。製品パッケージが指定するSnapshotを使用してください。

Q. Shared Knowledgeを更新したら全製品をすぐ更新する必要がありますか?

必要ありません。各製品で対応Snapshotを組み込んだ正式版が用意された段階で更新します。

Q. Shared Knowledgeは記事を直接改善しますか?

いいえ。Shared Knowledgeは共通知識とContractの正本です。実際の診断・改善・新規作成・統合はaDoctor、aWriter、aCreator、aMergeなどが担当します。

Q. 自分のサイト固有情報はShared Knowledgeに保存されますか?

原則として分離します。利用者やサイト固有の継続情報はPersonal Knowledge側で管理し、共通配布物であるShared Knowledgeには混在させません。

Shared Knowledge v3.6.0の役割まとめ

共通Contract・Enumを管理する
→ 編集・Evidence・品質ルールを共通化する
→ 製品ごとの役割境界を守る
→ Product-scoped Snapshotとして各製品へ反映する
→ Personal Knowledgeと共通知識を分離する
→ 実運用Learningを検証して共通知識へ昇格する
→ SIMS全体の品質と互換性を維持する

通常の利用者にとって最も重要なのは、Shared Knowledgeを単独で操作する必要はなく、最新版の各SIMS製品を正しい手順で使えばよいという点です。

関連ページ

利用者・サイト固有のKnowledgeについて確認する場合:

Personal Knowledge マニュアルへ →

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

SIMS マニュアル・FAQへ →

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

SIMSをはじめる →

simsをフォローする