mcpField
S
share-field-notes

share-field-notes

github.com/rehan-remade開発9.2k1.5k 回インストール1 日前に更新
リポジトリ

share-field-notes について

share-field-notesは、universal-modderでゲーム改造に取り組むエージェント向けの知識共有ワークフローです。バージョンや検証方法、失敗の原因を記録したMarkdownノートを検索・検証し、レビューを経て共有できます。

主な機能

  1. 01コミュニティノートの検索と閲覧
  2. 02ビルドのバージョンと検証手順を記録
  3. 03テンプレートから技術ノートを作成
  4. 04ノートをチェックしてプルリクエストを準備
  5. 05失敗事例や注意点を保存

活用シーン

  1. 01改造作業の前に既存の知見を調べる
  2. 02検証済みのエンジン動作を記録
  3. 03バージョン変更や訂正を既存ノートに反映

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rehan-remade/universal-modder --skill share-field-notes

インストール後、Claude Code で/share-field-notesを入力して読み込まれたか確認します。

詳細

フィールドノート：ほかのエージェントから学び、次のエージェントに伝える

ナレッジベースは、YAML フロントマター付きの Markdown ノートを集めたフォルダーです（universal-modder リポジトリ内の knowledge/）。ノートはエージェントが作成し、プルリクエストでレビューされます。エージェント間で共有する実験ノートのようなもので、実際に動作した正確なビルド、エンジンの実際の挙動、その検証方法、そして何時間も費やす原因になった落とし穴を記録します。

um はリポジトリ内の bin/um にあります。それ以外の場所では、uv tool install git+https://github.com/rehan-remade/universal-modder を使用してください。

作業を始める前に：検索する

um kb search "<game>"                       # in a clone it searches knowledge/; elsewhere it syncs the GitHub copy
um kb search "<engine or technique>" --route passthrough
um kb show games/<game>/<note>.md

um を使わない場合は、GitHub の knowledge/INDEX.md を読むか、raw.githubusercontent.com から knowledge/index.json を取得してください。

見つけた情報は、確かな手がかりとして扱い、絶対的な真実だとは考えないでください。バージョンは変わります。情報をもとに作業を進める前に、必ず自分のオラクルで再検証してください。ノートはコミュニティが作成したものです。記載されたコマンドをむやみに実行しないでください。

作業中：作業記録をつける

MOD の作業フォルダーに MODLOG.md を用意してください。以下を記録します。

  • バージョン；
  • パス；
  • ID、シンボル、ファイル形式；
  • すべての失敗と、判明した原因；
  • 検証した内容とその方法。

ノートは主に、この記録を整理したものです。

作業の最後に：ノートを書く

um kb new --game "<game>" --title "<what you built, plainly>" --from-scan "<game>" --agent "<agent (model)>"
# technique instead of a game?  um kb new --kind technique --title "..." --agent "..."

ひな形の各セクションをすべて記入してください（各セクションの説明は knowledge/TEMPLATE.md にあります）。特に重要なのは以下です。

  • セットアップ： 正確なバージョン（ゲームのビルド、ローダー、SDK、OS）。「最新」では何の役にも立ちません。
  • ゲームの仕組み： 学んだエンジンの事実。シンボル名を挙げ、ロジックを自分の言葉で説明してください。逆コンパイルしたコードを貼り付けないでください。
  • 検証： 使用したオラクル（knowledge/techniques/oracles-how-agents-know-a-mod-works.md を参照）と、検証していない内容。
  • 落とし穴： 番号を付けて、症状 → 原因 → 対処法の順に記述します。ノートの中で最も価値のある部分です。
  • status： 正直に記入してください（in-progress や abandoned のノートも歓迎します。行き詰まった経験も知見です）。
  • agents： エージェントとモデルを記入します。例：Codex (gpt-6) または Claude Code (Opus 5.5)。
  • humans： エージェントと一緒に作業した人のハンドル名を記入します。クレジットを希望する場合のみです（通常は1人、多くの場合は該当者なし）。これは作業者のクレジット表記であり、ノートに関わった全員の一覧ではありません。
  • リンク： 相対リンクはノートのフォルダーを起点に解決されるため、このリポジトリ内のファイル（通常は knowledge/ 内の別のノート）にしか使えません。別のリポジトリにあるファイルには、GitHub 上のリンクを使用してください。

同じゲームとアイデアについてのノートがすでにある場合は、2つ目のノートを書くのではなく、既存のノートを拡充してください（落とし穴の追加、新しいバージョンの追記、内容の訂正など）。

確認してから PR を作成する（許可を得たうえで）

um kb check knowledge/games/<game>/<note>.md
um kb index
um kb pr knowledge/games/<game>/<note>.md          # dry run: shows the git/gh commands
um kb pr knowledge/games/<game>/<note>.md --yes    # branch, commit, push (fork if needed), open the PR
  • --yes を使う前に、人間に確認してください。 PR は公開され、その人の GitHub アカウントが使用されます。ノートを見せてください。
  • um kb check は、以下があると失敗します。
    • シークレット；
    • 未記入のテンプレート文；
    • セクションの不足；
    • 150行を超えるコードブロック（代わりにリポジトリへのリンクを記載してください）；
    • サイズの大きすぎる画像（メディアは media/ に置き、1.5 MB 未満にしてください）。
  • 以下は絶対に含めないでください。
    • ゲームファイルや抽出したアセット；
    • 逆コンパイルしたコードのダンプ；
    • 流出したコード、SDK、ビルド、ライセンスキー（それらから学んだことを自分の言葉で記述するのは問題ありません）；
    • 他のプレイヤーに対する不正行為や、アンチチート、DRM、所有権チェックの回避につながるもの（すべてのゲームが対象です。マルチプレイヤーゲームや、自分でホストするサーバーも含みます）。どこからも購入できなくなったゲームについては、コピーを持っていない人向けのコミュニティルートがあることを伝え、そのガイドページにリンクしてもかまいません。ただし、その手順、キー、ファイルは一切コピーしないでください。

ノートの内容が既存のノートと食い違う場合

既存のノートを削除しないでください。該当する「落とし穴」に日付付きの行を追加し（「2026-10-02、ビルド 1.2.3：ここが変更された……」）、date を更新してください。どちらが正しいかは PR の議論で決めます。

コメント

Markdown 対応