【結論】高度な應用を段階的に実装する
高度な應用では、一つのPromptで取得、変換、公開まで実行せず、収集、検証、変換、承認、公開を分離します。
外部APIは公式Documentation、Authentication、Rate limit、Idempotency、Retry、Termsを確認します。
Claude Codeには実装とTestを任せ、本番Credentialと公開承認は人間またはCIの保護環境で管理します。
# ターミナルで実行：SecretをCommitしない雛形を作成
printf '%s\n' 'SERPAPI_KEY=' 'DEPLOY_TOKEN=' > .env.example
# ターミナルで実行：Dry Runを実行
python pipeline.py --input fixtures/news.json --dry-run
# ターミナルで実行：Testを実行
pytest -q
# ターミナルで実行：変更差分を確認
git diff --check && git diff --stat具体的な手順・設定方法
入力・出力Schema、失敗時の状態、再実行条件を定義します。
外部APIごとにAdapterを分け、MockとFixtureでTestします。
Dry Runでは送信予定Payloadと変更予定Fileだけを出力します。
Production deployはEnvironment protectionと人間承認を通します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
技術News収集Pipelineの設計を作成してください。
収集、正規化、重複排除、下書き生成、承認、公開を分離してください。
外部API呼び出しとDeployは行わず、Mockを使うTest計画を提示してください。注意点・よくあるエラーと対処法
利用規約で禁止されたScrapingや自動投稿を実装しないでください。
存在しないAPIや非公開Endpointを推測してCodeへ組み込まないでください。
Retryには指数Backoff、最大回数、Idempotency key、Dead-letter相当の記録を設けます。