Jenks Guo

ドキュメント / tutorials

はじめてのAI支援による編集

Jenks向け — AIの支援で最初のコンテンツ変更を行い、dev.jenksguo.xyzでプレビューし、本番サイトへプロモートします。

このドキュメントの対象者

このチュートリアルは、このサイトの唯一の管理者であるJenks向けです。サイトのモデルに、ある1つの経験エントリへの変更案の下書きを依頼し、差分を確認し、devブランチに適用し、プレビューを確認してから公開します。プロモートするまで本番サイトには反映されません。

始める前に

jenks CLI（エージェントを接続するを参照）と、content スコープを持つエージェントトークンが必要です。コンソールの https://admin.jenksguo.xyz/admin → Access で作成し（AIエージェントにアクセス権を付与するを参照）、このセッションに限りシェルへ読み込みます。

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…

トークンをチャット、コミット、コンテンツファイルに貼り付けてはいけません。

ステップ1 — アクセス権を確認する

jenks admin whoami

トークンが有効で、GitHubへの公開が構成されていることが表示されます。公開が構成されていない場合でも、編集の検証はできますがコミットはできません。

ステップ2 — 現在のエントリを読む

jenks admin get xero-developer-evangelist

これにより生のソースが出力されます。YAMLフロントマター（title、dates、tags、lenses、metrics、proof）とMarkdown本文（Overview、What Jenks did、Achievements、Why it matters to employers）です。変更する前に読み、後でAIの下書きと見比べます。

ステップ3 — AIに下書きを依頼（dev上）

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev

サイトのモデルがファイルを書き直し、次の3つを返します。

  • 提案されたコンテンツ
  • 現在のファイルとの差分である diff
  • ビルドと同じスキーマでの 検証問題（あれば）

まだ何もコミットされていません。

ステップ4 — diffをレビューする

1行ずつ確認します。

  • すべての事実が真実と一致していること。AIは数値、日付、主張を追加してはいけません。
  • 公式な職務名が変更されていないこと。
  • Tags と lenses が依然として有効であること（バリデータは未知のものを警告します）。

下書きが不適切な場合は、より明確な指示で ai-edit を再実行するか、自分でファイルを編集して jenks admin put を使用します。

ステップ5 — devに適用する

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev --apply

--apply は提案を再度検証し、dev ブランチにコミットします。

ステップ6 — パイプラインを監視する

jenks admin deploys

CIは変更されたエントリを他の6言語に再翻訳し、サイトを再ビルドしてdevブランチをデプロイします。通常は数分かかります。

ステップ7 — プレビューを確認する

https://dev.jenksguo.xyz/career/xero-developer-evangelist と、https://dev.jenksguo.xyz/zh/career/xero-developer-evangelist のような翻訳版を開きます。開発サイトは検索エンジンにインデックスされません。

ステップ8 — 公開する

jenks admin promote

これにより dev が main にマージされます。続いてCIが本番サイトをデプロイします（jenksguo.pages.dev と jenksguo.xyz は同時に更新されます）。

学んだこと

  • AIは下書きし、決定するのはあなたです。ai-edit は --apply なしでは決してコミットしません。
  • 同じバリデータがCLI、REST API、MCP、/admin コンソールを保護します。
  • 翻訳は自動で追随し、git履歴がすべてのバージョンを保持するため、どんな変更でも元に戻すことができます。

次のステップ：Update content with AI では、複数ファイルの変更や他の編集方法を扱います。

.mdこのページはAIの支援で翻訳されています。正式な肩書は英語のままです。