AI でコンテンツを更新する

入り口は4つ、ルールは1つ

すべての管理編集は同じ admin API を通ります。人は Google (Cloudflare Access) でコンソールにサインインします。エージェントやスクリプトは、コンソールで作成したサービス トークンを使用します — 詳細は Give an AI agent access をご覧ください。状況に合うものをお選びください:

インターフェース	最適な用途
Console at https://admin.jenksguo.xyz/admin	手作業での編集: フォーム項目、メディアライブラリ、変更差分、プレビューを備えたビジュアルエディタ
CLI jenks admin …	端末やスクリプトからの迅速な編集
Admin MCP (/mcp/admin or jenks mcp --admin)	Claude Code などの AI エージェントに作業を任せる場合
REST /api/admin/*	独自の自動化

あらゆる書き込みはコンテンツスキーマで検証され、git にコミットされます。CI は変更されたエントリをすべての言語へ再翻訳し、再ビルドとデプロイを行います。別の言語を自分で書く場合 — 翻訳やインターフェース文言 — は Edit the site in any language をご覧ください。

トークンを読み込む

content スコープを持つエージェントトークン (jgx_agt_…) を使用します。ライブサイトへ直接書き込む可能性がある場合は publish も付与します:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks admin whoami                      # shows the token's name, scopes and expiry

書く前に読む

jenks admin schema                         # fields, tags, lenses, writable paths
jenks admin ls content/corpus/experiences  # files and their sha
jenks admin get linktree-partner-solutions-lead

検証してから書く

ファイルをローカルで編集し、検証してからコミットします:

jenks admin get linktree-partner-solutions-lead > linktree.md
# …edit linktree.md…
jenks admin validate content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md
jenks admin put content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md \
  -m "Linktree: add developer portal launch detail" --branch dev

検証に失敗した書き込みは拒否されます。そのため、不適切な編集でビルドが壊れることはありません。

AI に下書きさせる

jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev
jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev --apply

最初の呼び出しは提案内容、差分、検証上の問題を返します。2 回目はそれをコミットします。

複数のファイルを1回のコミットで変更する

admin_commit_changes (MCP) または JSON ファイルとともに jenks admin commit を使用します:

{
  "changes": [
    { "path": "content/corpus/community/murrumbeena-school-council.md", "content": "---\n…" },
    { "path": "content/corpus/capabilities.md", "content": "…" }
  ]
}

jenks admin commit changes.json -m "School council: confirm dates" --branch dev

ファイルを削除するには { "path": "…", "delete": true } を使用します。

エージェントに依頼する

admin MCP サーバーが接続された状態で、次のように平易にエージェントへ指示します:

スキーマを読み込んでください。Virginia Park Childcare のエントリを、期間が 2019 — 2024 と読めるように更新してください。検証し、明確なメッセージで dev にコミットし、その後デプロイ状況を見せてください。

適切に動作するエージェントは、admin_schema、admin_read_file、admin_validate、 admin_write_file、admin_deploy_status の順に呼び出します。

守るべきルール

• dev を非トリビアルな変更に使用し、https://dev.jenksguo.xyz を確認してから昇格させます。 Preview and promote を参照してください。
• 事実のみを書きます。コンテンツは Ask Jenks アシスタントの情報源であり、真実として扱われます。根拠のない数値、肩書き、主張を AI に追加させないでください。
• コンテンツに機密情報を含めないでください — トークン、電話番号、自宅住所、推薦者の詳細など。content/ 配下はすべて公開されます。
• 英語で執筆します。ほか 6 言語への翻訳は CI が生成します。content/corpus/i18n/glossary.json の用語集は見出しやレンズ名を固定します。
• 元に戻すのは 1 回のコミットで可能です。Git の履歴にすべての版が保存されます。