withとAIエージェント

withのmacOS版を公開してそろそろ二週間が過ぎようとしています。この間にも〈宇宙島年代記〉のエピソード「幽霊船」の第三話をwithで書き、入稿して、いくつかのバグ修正と新機能の追加を行っています。

Mac版: with story

基本機能無料
アプリ内購入でPro版機能を開放

iOS版: with to go

iPhone、iPad版:500円

そしてAIエージェントの助けも借りています――といっても、翻訳の可能性がある小説なので小説本文の出力は行っていません。エージェントを使うのは資料作成です。私はCodexを用いて、原稿から登場人物、乗り物、道具、歴史に関する設定書をwikiで作ってもらっています。VS CodeのFoamで視覚化するとこのようになります。

全資料のネットワーク
ファルム・カズミを中心に見た資料
シーンに関連する資料のネットワーク

原稿から資料を作成し、そのネットワークを作らせる。もちろん人手でもできますが、アルゴリズムでやらせようとするとちょっと難しい。単語の出現だけでなく、関連の度合いなどを文脈に応じて拾い上げるような作業は、人間か、またはLLMにしかできない作業です。私はこの作業をCodexにやらせています。

withはフォルダーの並び順をアプリケーションの中で決めるので、ファイルだけ見ていても原稿の並び順は分かりません。また、withで資料として扱う.mdにはフロントマター(冒頭に付与する指定書式)があると便利です。そこでCodexにwithのプロジェクトを理解してもらうために、Agents.mdと、いくつかの書類を書いています。

今日はそのファイルを共有します。以下の三つのファイルをプロジェクトフォルダーに置いて、CodexでもClaude Codeでも、Cursorにでも頼んでみてください。

いずれwithにはMCPを追加しますが、それまでは、時々更新するこのagents.mdとdocs以下のファイルを使って、エージェントに指示を出してください。このagents.mdを入れたプロジェクトで「登場人物の資料を作成してください」と入力すると、AIエージェントは必要な資料を作ってくれます。

このagents.mdでは、他にもmacOSの日本語入力用の辞書を作成することも可能です。「日本語入力用の辞書を作成してください」と言えば、固有名詞や場所の辞書を作ってくれます。

agents.md
# with project執筆支援ガイド

## プロジェクトの目的

このリポジトリは、小説プロジェクトである。エージェント の役割は、既存原稿と資料を根拠に情報を整理し、設定・構成・人物造形について執筆者の相談相手となり、校正を支援することである。

## 基本方針

- 執筆者の意図、既存原稿の事実、語り口を尊重する。
- エージェント は基本的に原稿本文を生成・追記・書き換えしない。原稿ファイルへの変更は、執筆者から明示的な依頼がある場合に限る。
- 原稿本文の代筆を求められていない相談では、設定案、選択肢、論点、整合性の検討を提示する。案を既存設定と混同せず、「原稿で確認できる事実」「資料にある設定」「提案・推測」を区別する。
- 不明な事実を補完して断定しない。原稿や資料で確認できない場合は、その旨を明記する。
- 大きな変更や新設定を勝手に正史として採用しない。候補として提示し、執筆者の決定を待つ。

## 原稿の参照方法

- 原稿本体は `./**/*.txt`、または`./原稿/**/*.txt` にある。
- 作品全体や複数シーンを読むときは、ファイル名やファイルシステムの列挙順ではなく、`.with/project-index.json` の `entries` を使って読む。
- `relativePath` が `原稿` 以下で、`kind` が `manuscript`、かつ `isMissing` が `false` の項目を対象とする。
- 読む順番は `parentId` による階層を復元し、各親の直下で `sortKey` の昇順とする。フォルダーも順序を構成する要素として扱い、その中を同じ規則で再帰的にたどる。
- `sortKey` がない項目やインデックスと実ファイルに食い違いがある項目は、推測で順序を確定せず、食い違いを報告する。
- 一部の場面だけが指定された依頼では、まず指定範囲を読み、人物関係や前後関係の確認に必要な範囲だけを原稿順に追加で参照する。
- `Plot/` や既存の `資料/` は補助情報として参照できるが、完成済み原稿と矛盾する場合は、原稿上の記述を優先して矛盾を報告する。作者が明示した最新方針はそれらより優先する。

## 資料カードの作成

- 人物、組織、場所、技術、道具、事件、世界設定などの資料作成を依頼された場合は、`./資料/` 以下に Markdown(`.md`)で作成する。フォルダーがなければ作成する。
- 形式はプロジェクトルートの `reference-card-markdown-spec.md` に従う。作成前に必ず同仕様の最新版を確認する。
- 原則として一つの主要対象につき一ファイルとし、分かりやすく安定した名称を付ける。関連カードは Foam 互換の Wiki リンク(例: `[[セブン]]`)で結ぶ。
- 必要に応じて YAML frontmatter を設ける。少なくとも内容に合う `type` と `title` を使い、値を捏造して埋めない。
- 原稿への参照は、仕様に従い原稿ルートからの相対パスを使う。シーン ID を確認できる場合、本文末尾の `## 登場シーン` に `[[scene:UUID|ラベル]]` を記載し、同じ ID を重複させない。
- カード本文では、原稿から確認できる事実を中心に簡潔に整理する。解釈、未確定事項、矛盾、執筆上の提案は見出しを分け、事実と混ぜない。
- 原稿にない人物像、動機、経歴、技術仕様などを事実として追加しない。依頼に応じて考案した設定は「案」「未確定」などと明示する。
- 出典を追跡できるよう、重要な事実には可能な範囲で原稿リンクまたは登場シーンを付ける。原稿の長文転載は避け、要約を基本とする。
- 資料作成のために原稿を変更しない。また、`.with/project-index.json` や `.with/paragraph-ids.json` は手作業で編集しない。

## 設定相談と整合性確認

- 相談された論点に関係する原稿、既存資料、必要に応じて `Plot/` を確認してから回答する。
- 回答では、既存描写との整合性、人物の動機、時系列、情報の開示順、技術的な説得力、物語上の効果を必要な範囲で検討する。
- 複数案を出す場合は、各案の利点、弱点、既存原稿へ及ぼす影響を短く示す。
- 現代の技術、製品、制度、地理など正確さが必要で変化し得る情報は、必要に応じて信頼できる最新資料で確認し、創作上の脚色と現実の事実を区別する。
- ハッキング描写では、物語上のリアリティと用語の正確さを支援する。現実の第三者への不正アクセスや被害につながる実行支援へ目的が変わった場合は、創作上・防御上の説明に範囲を戻す。

## 辞書登録

- 人物、組織、場所、製品、技術など、`資料/` と `原稿/` に登場する作品固有の固有名詞を確認し、`dict/[プロジェクト名]辞書.txt` に追記する。
- 原稿を横断して確認するときは、「原稿の参照方法」に従い、`.with/project-index.json` から復元した原稿順で参照する。
- 登録形式と使用可能な品詞は、プロジェクトルートの `input-method-dictionary.json` を参照する。各項目は `よみ,単語,品詞` の形式とし、品詞には同ファイルの `pos.enum` にある値だけを使う。
- 既存の `dict/[プロジェクト名]辞書.txt` を事前に検索し、同じ「よみ・単語・品詞」の項目を重複登録しない。既存の分類や話数見出しを尊重し、対応する位置へ追記する。
- 読みや正式表記は、原稿または資料で確認できるものだけを登録する。確認できない読みを推測で補わず、未登録または要確認として報告する。
- ルビ記法を含む変換候補を登録する場合も、原稿で確認できる読みと表記を使い、通常表記の項目と混同しない。
- 資料カードを新規作成・更新した際は、そこに登場する新しい固有名詞についても辞書登録の要否を確認する。

## 校正

- 校正を依頼された場合は、指定された原稿を読み、誤字脱字、脱字・衍字、助詞や文法上の不自然さ、句読点、括弧の対応、固有名詞、数字・英字・記号、送り仮名などの表記揺れを指摘する。
- 文脈上意図的と思われる口語、人物固有の話し方、演出、リズムは機械的に直さない。確信が持てないものは誤りと断定せず「要確認」とする。
- 既出箇所との表記揺れを調べるときは、指定ファイルだけでなく必要な範囲の原稿と辞書も検索する。
- 原則として原稿は直接修正せず、`ファイル:行番号`、該当箇所、指摘内容、修正候補を示す。執筆者から修正まで明示的に依頼された場合のみ、承認された範囲を編集する。
- 校正と推敲を分ける。語調、テンポ、構成、内容に踏み込む提案は「推敲案」などとして分離し、誤字脱字の修正と混同しない。

## 変更時の注意

- 既存ファイル、作者の未コミット変更、文字コード、改行、Unicode のファイル名を尊重する。
- 依頼範囲外のファイルを整理、改名、削除しない。
- 作業後は、作成・変更したファイルと要点、未確定事項や見つかった矛盾を簡潔に報告する。
reference-card-markdown-spec.md
# 資料カード Markdown 仕様

この文書は、資料カードを `.md` として保存し、macOS / iOS の文脈ペインや専用エディターで扱うための仕様メモです。

## 基本形式

- 資料カードは Markdown ファイルとして保存する。
- 必要に応じて YAML frontmatter を持つ。
- frontmatter は検索・分類・表示補助に使い、本文としては表示しない。
- 人間が直接読める本文を正とし、アプリ固有の情報は本文を壊さない形で追加する。

```markdown
---
type: setting
title: "技術水準"
captured: 2026-06-30T17:58:51+09:00
source: "MCP"
tags: []
---

# 技術水準

本文...
```

typeは
- setting
- character
- place
- event
- other
です。

## Wiki リンク

資料カード内のリンクは Foam 互換の Wiki リンクを基本にする。

```markdown
[[ページ名]]
[[ページ名|ラベル]]
```

- 資料フォルダー以下の `.md` をリンク対象にする。
- 資料フォルダー内のサブフォルダーは Foam スタイルでフラットに解決できる。
- つまり `資料/身体改変/拡張肢.md` は `[[拡張肢]]` で開ける。
- 同名のファイルとフォルダーがある場合は `.md` ファイルを優先する。
- ファイルがなくフォルダーが見つかった場合は、そのフォルダーを文脈グループとして開く。
- 解決できないリンクは無効リンクとして表示する。

## 原稿リンク

原稿へのリンクは、原稿ルートからの相対パスを拡張子なしで書ける。

```markdown
[[原稿/階層/テキストファイル#見出し名]]
```

- 原稿フォルダーが設定されていない場合は、プロジェクトルートを原稿ルートとして扱う。
- `#見出し名` はファイル内の見出しを指す。
- 上位パート名の変更で壊れやすい参照には、将来的に安定 ID を併用する。

## 画像

画像は Markdown の画像ブロックとして、本文内の段落に挿入する。

```markdown
![スーツケース]
![スーツケース](画像/スーツケース.png)
```

- `![ラベル]` は、画像フォルダー内の同名画像を自動解決する。
- `![ラベル](path)` は通常の Markdown 画像として解決する。
- 画像ブロックは通常の本文ブロックとして扱い、クリック編集時は Markdown タグに戻す。
- 表示時は本文幅に収める。
- 画像の最大幅は表示可能な本文幅の `100%` とする。
- 画像の最大高さは表示可能な本文幅と同じ値を上限にする。
- 縦長画像でも、コンテキスト本文幅を超える高さを持たせない。
- アスペクト比は維持し、収まるように `contain` 相当で表示する。

## サムネール

資料カードの代表画像はサムネールとして扱う。

- macOS の文脈ペインではサムネール幅を 200pt 固定にする。
- 十分な幅がある場合は、先頭見出しと第一ブロックをサムネールと並べて表示する。
- 幅が狭い場合は、見出し、サムネール、第一ブロックの順で縦積みにする。
- サムネールは本文内画像とは別の代表画像であり、本文中の画像段落は通常の画像ブロックとして表示する。

## 登場シーン

登場シーンは frontmatter ではなく、本文末尾の専用セクションに保存する。

```markdown
## 登場シーン

- [[scene:UUID|ラベル]]
```

- UI 上は「登場シーンを追加」として扱う。
- `scene:` は原稿パスではなく、シーン ID へのリンクを意味する。
- ID が見つからない場合は無効リンクとして表示する。
- ラベルは表示用であり、上位パート名が変わっても ID で解決する。
- 同じ scene ID は重複追加しない。

## iOS 編集方針

iOS では、資料カードの閲覧はシートで行い、編集したい場合は専用エディターへ移動する。

専用エディターは本文エディターのサブセットとして構成する。

- メタデータ編集: 名前変更、サムネール選択、種別選択、タグ入力。
- カーソルツールバー: 本文エディターと同じ。
- 見出しツールバー: 地付き、付箋を外す。
- 挿入: Wiki リンク、登場シーン、画像。

見出しやルビなどの装飾は控えめにし、資料カード向けには画像挿入や登場シーン登録を優先する。
input-method-dictionary.json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "macOS 日本語入力ユーザー辞書 スキーマ",
  "type": "object",
  "description": "macOS 日本語入力(ことえり・日本語IM)ユーザー辞書のスキーマ",
  "properties": {
    "dictionaryName": {
      "type": "string",
      "description": "辞書名(任意)"
    },
    "description": {
      "type": "string",
      "description": "辞書の説明(任意)"
    },
    "entries": {
      "type": "array",
      "description": "ユーザー辞書エントリ一覧",
      "items": {
        "type": "object",
        "required": ["yomi", "word", "pos"],
        "properties": {
          "yomi": {
            "type": "string",
            "description": "入力するひらがな",
            "propertyOrder": 1,
            "examples": ["でんき", "たなか", "うつくしい"]
          },
          "word": {
            "type": "string",
            "description": "変換候補となる語(表記)",
            "propertyOrder": 2,
            "examples": ["電気", "田中", "美しい"]
          },
          "pos": {
            "type": "string",
            "description": "品詞(macOS 日本語入力プログラム用の品詞)。num のいずれか1つのみを指定すること。独自品詞や補助分類(例:外来語)は禁止。",
            "propertyOrder": 3,
            "enum": [
              "普通名詞",
              "人名",
              "姓",
              "名",
              "その他の人名",
              "単純地名",
              "接尾語付き地名",
              "組織名",
              "その他の固有名詞",
              "サ変名詞",
              "形動名詞",
              "連体詞",
              "副詞",
              "接続詞",
              "感動詞",
              "カ行五段",
              "サ行五段",
              "タ行五段",
              "ナ行五段",
              "マ行五段",
              "ラ行五段",
              "ワ行五段",
              "ガ行五段",
              "バ行五段",
              "五段動詞",
              "一段動詞",
              "サ変動詞",
              "ザ変動詞",
              "形容詞",
              "形容動詞",
              "数字列接頭語",
              "人名接尾語",
              "地名接尾語",
              "組織名接尾語",
              "成句",
              "無品詞"
            ]
          }
      }
    }
  },
  "required": ["entries"],
  "additionalProperties": false
}

最後に、LLMサービスを利用することに関する私見を述べます。

LLMで駆動するコーディングエージェントは、創作の分野でも私たちの活動を変えていくことになるでしょう。執筆そのものには限りません。翻訳や検索の補助、書類の整理などで、生成AIやLLMを用いたツールは、今までのプログラムでできないこと、人間には現実的な時間でできなかった力を与えます。

使うものかと目を背けようとしても、LLMによる要約を目にしない日はありません。Googleを通過する添付ファイルは全てGeminiに読み取られていますし、Xに投稿すればGrokの資料になり、Facebookに投稿したならmetaの材料になってしまいます。広告の半分がAIに置き換わる日もそう遠くないでしょう。もうLLMはコンピューティングの一部になってしまっています。

取捨選択はするでしょうが、私はLLMを、その力を使う技術を享受し、広めていくことでしょう。

だからこそ、OpenAIやGoogle、meta、DeepSeek、Antholopicには、より公正であってほしいと願っています。私は俗に学習と称されるフェアユースや著作権法30-4による資料の利用を否定しません。しかし、不正にコピーされた資料や、性的加害を含む資料を用いたソフトウェア開発はやめていただきたい。すでに辞めたのなら、そう宣言していただきたい。海賊版訴訟に負けた腹いせに古書を買い占め、スキャンしたら焼いて捨てるようなこともやめていただきたい。国際的な著作権法は、パブリックドメインになった古書のデータを公開することを認めています。機会が失われていく職業への目配せや、資料の利用ライセンスにも積極的に取り組んでいただきたい。今ならできるはずです。

“withとAIエージェント” への1件のフィードバック

コメントを残す