JGJenks Guo

ドキュメント / tutorials

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

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

対象読者

このチュートリアルは、サイトの唯一の管理者であるJenks向けです。サイトのモデルに依頼して、ある実績エントリへの変更案を作成し、差分を確認し、devブランチに適用して、プレビューを確認し、その後公開します。プロモートするまで、jenksguo.xyzには反映されません。

はじめる前に

jenks CLI（Connect your agentを参照）と管理者トークンが必要です。トークンはmacOSのKeychainで agent-env:JENKSGUO_ADMIN_TOKEN として保管されています。次のコマンドで、このセッションに限りシェルへ読み込みます。

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

トークンをチャット、コミット、コンテンツファイルに貼り付けないでください。

ステップ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をレビューする

行ごとに確認します。

  • すべての事実が真実と一致していること。AIは数値、日付、主張を追加してはいけません。
  • 公式な職務タイトルが変更されていないこと。
  • タグとレンズが引き続き有効であること（バリデータは未知のものを警告します）。

ドラフトが不正確な場合は、より明確な指示で再度 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.xyzをデプロイします。

学んだこと

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

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

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