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

入口は4つ、規則は1つ

すべての管理編集は同じ管理APIを通り、あなたの個人トークン（agent-env:JENKSGUO_ADMIN_TOKEN in the Keychain）で保護されます。状況に合う方法をお選びください:

インターフェース	最適な用途
Console at https://jenksguo.xyz/admin	ライブプレビューを見ながら手作業での閲覧と編集に最適
CLI jenks admin …	ターミナルやスクリプトから素早く編集するのに最適
Admin MCP (/mcp/admin or jenks mcp --admin)	Claude Code などのAIエージェントに作業を任せたいときに最適
REST /api/admin/*	独自の自動化に最適

すべての書き込みはコンテンツスキーマに対して検証され、git にコミットされます。CI は変更されたエントリをすべての言語に再翻訳し、リビルドしてデプロイします。

トークンを読み込む

export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"
jenks admin whoami

書く前に読む

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 } を使用します。

エージェントに依頼する

管理用 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 の用語集が見出しやレンズ名を固定します。
• 取り消しはコミットひとつです。 Git の履歴がすべてのバージョンを保持しています。