🩹 失敗談・トラブル解決
詰まったところと、その直し方。うまくいかなかった話ほど詳しく書きます。
AI開発で秘密を漏らさない｜.env・ログ・依頼文の確認リスト
AIコーディングでAPIキーやトークンを漏らさないために、.envと.gitignoreの使い方、ログや依頼文の伏せ方、漏えい疑いの初動、自動検査の考え方を解説します。
AIの失敗ログを捨てない：次の自動化を強くする振り返りノート術
AIエージェントの失敗を症状と原因に分け、コマンド出力と対応を記録し、似た失敗をまとめて注意事項から再発防止の仕組みへ変えるための、実践的な振り返りノート術を解説します。失敗が3件たまった時の見直し方も紹介します。
AIエージェントが外部の命令にだまされないための実践ガード
Webページやメールに紛れた外部の命令をAIが本当の依頼と取り違えないよう、命令と資料の分離、権限の制限、実行前確認、模擬テストを重ねて事故の広がりを防ぐ実践策を解説します。外部入力を扱う停止条件の決め方も学べます。
APIの429エラー対策｜Retry-Afterと指数バックオフの実装手順
APIが429 Too Many Requestsを返したときに、制限単位の確認、Retry-Afterの解釈、指数バックオフとジッター、停止条件、ログ設計までをNode.jsの例で解説します。
AstroをCloudflare Pagesで再読み込みすると404になるときの確認順
AstroのページをCloudflare Pagesで直接開く、または再読み込みすると404になる問題を、生成済みHTML、動的ルート、末尾スラッシュ、リダイレクト、SPA設定の順に切り分けます。
Astro Content Collectionsの型エラーを直す｜schemaと記事データの照合手順
Astro Content Collectionsで記事データがschemaに合わないとき、対象ファイル、必須項目、日付、列挙値、schema変更の影響を順番に切り分ける方法を解説します。
Codexが止まった原因をログで調べる｜終了コード・権限待ちの技術診断
Codexの画面操作は確認済みの人向けに、最後の出力、標準エラー、終了コードから待機・コマンド失敗・権限待ちを切り分け、安全に再開する手順を解説します。
終了コードの確認方法｜PowerShell・コマンドプロンプト・GitHub Actionsの違い
Windowsでコマンドの終了コードを確認し、PowerShell、コマンドプロンプト、GitHub Actionsへ失敗を正しく引き渡す方法をコード例付きで解説します。
ローカルでは成功するのにGitHub Actionsで失敗する原因｜環境差の切り分け方
ローカルでは通る処理がGitHub Actionsだけで失敗するとき、Node.js、依存関係、OS、環境変数、権限、作業ディレクトリ、キャッシュの差を順に切り分けます。
GitHub ActionsでSecretsが使えない原因｜pull_request時の安全な設計
GitHub Actionsのpull_requestでSecretsが空になる原因を切り分け、フォークPRを秘密なしで検品し、信頼後の工程と安全に分ける方法を解説します。
JSONのエラーを直す｜Unexpected tokenから原因行を見つける手順
JSON.parseで構文エラーが出たときに、エラー位置の読み方、末尾カンマや引用符、改行とエスケープ、巨大JSONの切り分け、修正後の検証まで順番に解説します。
ログから必要な行だけ抜く正規表現｜日時・レベル・メッセージの実例
形式を固定した架空ログを使い、JavaScriptの正規表現で日時やERROR行を抽出し、名前付きグループと複数行ログを安全に扱う方法を解説します。
Node.jsのバージョン違いを直す｜ローカルとCIを同じ環境にそろえる
Node.jsのバージョン違いでインストールやビルドが失敗するとき、現在値と要求版を確認し、ローカル、package.json、GitHub Actionsをそろえる手順を解説します。
npmのERESOLVEエラーを直す｜依存関係の競合を安全に解消する手順
npm installでERESOLVEが出たときに、競合パッケージと要求バージョンを読み、package.jsonとlockfileを最小限の変更でそろえる手順を解説します。
正規表現の作り方｜検索・置換を壊さない小さな試し方
JavaScriptの正規表現を、普通の文字列から少しずつ組み立て、置換前に境界値と期待結果を確かめる手順を解説します。
robots.txtとsitemapのトラブル解決｜検索エンジンに記事が見つからないときの確認順
公開した記事が検索エンジンに見つからないときに、クロール、robots.txt、sitemap、canonical、HTTPステータスを順番に切り分ける方法を解説します。
UTF-8の文字化けを直す｜Windows・Markdown・ターミナルの確認手順
UTF-8の文字化けを、発生箇所、ファイルの実体、BOM、ターミナル、読み書き処理の順に切り分け、安全に直して差分を検査する手順を解説します。
Claude CodeでWindowsのパスエラーを直す｜空白・日本語・バックスラッシュの対処法
Claude CodeをWindowsで使うときのパスエラーを、空白、引用符、バックスラッシュ、日本語フォルダ、相対パスの順に切り分ける手順を解説します。
Codexのsandboxエラーを解決する｜書き込み範囲と権限不足の切り分け
Codexでファイルの書き込みやコマンド実行が拒否されたときに、sandboxの境界、作業ディレクトリ、書き込み先、承認の要否を順番に切り分ける方法を解説します。
環境変数を読み込めない原因｜.env・PowerShell・GitHub Actionsを順に確認する
環境変数がundefinedや空になるときに、変数名、スコープ、.envの場所、PowerShell、GitHub ActionsのSecretsを安全に切り分ける手順を解説します。
Markdownのfrontmatterエラーを直す｜区切り・日付・引用符のよくあるミス
Markdownのfrontmatterを解析できないときに、区切り線、コロンを含む文字列、日付、配列、真偽値、schemaの不一致を順番に直す方法を解説します。
Codexが途中で止まるときの直し方｜画面・通信・指示を初心者向けに診断
Codexの画面が動かない初心者向けに、許可待ち、指示の迷い、通信・端末の問題を見分け、二重実行を避けて安全に再開する手順を解説します。
自動投稿が失敗した話｜止まっていたのは投稿ボタンの手前だった
自動投稿が出なかった実例から、ログイン状態を原因として切り分けた流れと、同じ失敗を防ぐ確認手順を初心者向けに紹介します。