ツールとコード– category –
使ってよかったツールの紹介と、実際に動くコード。短いスニペットから実用スクリプトまで。
-
Git とバージョン管理
Gitのブランチとマージ — コンフリクトの読み方と解消手順
ブランチを2本切って合流させ、わざとコンフリクトを起こして解消するまでを手を動かして確かめます。ブランチがコピーではないこと、消しても中身が残る理由まで扱います。 -
自動化スクリプト
Windowsタスクスケジューラの設定手順 — cronとの違いと動かないときの確認
手では動くのにタスクだと動かない原因を、作業ディレクトリ・実行ユーザー・特権の3つに分けて実際に踏みます。既定で無効な履歴の有効化と、結果コードの読み方まで扱います。 -
Git とバージョン管理
Gitで変更を取り消す方法 — reset・revert・reflogの違いと使い分け
git reset --hard で消したコミットは reflog から戻せます。作業ツリー・ステージ・HEAD の3つを分けて考え、reset・revert・reflog・stash の使い分けを、わざと壊しながら確かめます。 -
AIと組んで開発する
丸投げでは完成しない — AI開発の到達作品
前回は「AIが書いた差分は読まずに入れない」という心構えを確認しました。今回はその心構えを持ったまま、実際に Claude と組んで小さなツールを1つ、ゼロから動くところまで作ります。作るのはコマンドラインの家計簿です。この記事の主役はコードではなく、頼み方・受け取り方・直し方の往復そのものです。実際のプロンプト、返ってきたコード、そこに混ざっていた2つの間違い、それをどう指摘して直させたかを、隠さず順番に残します。AI同士の優劣は比べません。使うAIは Claude 1つに固定し、1つの道具の1つの使い方を最後まで見せます。そしてこのサイト自体が Claude Code で書かれていることも、正直に開示します。 -
Git とバージョン管理
GitとGitHubは別物 — VMのコードを初めて上げる
Gitの回は「手元で履歴を残す」ところで止まっていた。その続き。VMの中にあるコードをGitHubに上げるまでを、SSH鍵の登録・.gitignore・push が拒否されたときの読み方つきで。.env を上げてしまうと消しても履歴に残る、という一番怖いところも書いた。 -
エディタとターミナル
インデントは人が指摘しない — ESLintとPrettier
リンタ(間違いを見つける)とフォーマッタ(見た目を揃える)は別物。ESLint 9系のフラット設定と Prettier を ~/server と ~/react-demo に入れ、両者を喧嘩させない書き方、保存時に自動で直すVS Codeの設定、そしてCIで落とすところまで。既存コードに後から入れると大量に警告が出る問題は、一度に直さず段階的に有効化する。 -
Git とバージョン管理
一人でもmainに直接コミットしない — PRとレビュー
一人で作っていても、ブランチ・プルリクエスト・レビュー・マージは今日から回せます。むしろ一人のときこそ必要です。mainに直接コミットし続けると何が戻せなくなるのかを具体的に確かめたうえで、ブランチを切ってPRを作り、自分でレビューし、CIが落ちたPRはマージできないブランチ保護を入れるところまでを一周します。自分のPRは自分でApproveできない、無料プランの非公開リポジトリではブランチ保護が使えないことがある、といった実際に詰まる場所も、回避策のコマンド付きで書きました。コンフリクトはわざと起こして直します。 -
AIと組んで開発する
AIが書いた差分は読まずに入れない — AIを開発に使う
前回はLLMの中身を見ました。今回は「作る側」ではなく「使う側」です。AIに書かせると速いのは本当ですが、速いのは書くところだけで、読む・確かめる・直すは1ミリも減りません。この記事の山場は、実際にAIに ~/server へ小さな機能を足させ、その差分を1行ずつ読むところ。実際に3つの間違いが出てきます。使っていない依存が増える、頼んでいない仕様変更が混ざる、そしてテストは通る。git diff で読む → テストを走らせる → 通ってから入れる、という順番を固定します。危ないこと(秘密情報・ライセンス・自信満々の嘘・実行範囲)と、MCPが何なのかも。このサイト自体がAIと一緒に書かれているので、何を人間が確かめているかも開示します。 -
自動化スクリプト
cronは動かなくても何も言わない — 定期実行とsystemd timer
バックアップを cron に1行載せた、その先の話。手で打つと動くのに cron だと動かない3つの理由(PATH・%・カレントディレクトリ)を、実際に起こして直します。山場は「失敗に気づける形にする」で、出力を捨てない・終了コードを見る・最後に成功した時刻を残す、の3段構え。同じジョブを systemd timer に書き換えて、cron との違いと多重起動の防ぎ方、タイムゾーンで1日ずれる話まで。最後に、作ったジョブを全部止めます。 -
自動化スクリプト
スクレイピングは技術より先に線引き — 練習は自分のVMで
「このデータが欲しい」と思ったとき、最初にやることはコードを書くことではありません。公式APIがあるか、利用規約は何と言っているか、robots.txt はどうなっているか、そのデータは誰のものか。この4つを先に確かめます。そのうえで、相手に迷惑をかけないための技術(間隔を空ける・同時接続を絞る・連絡先を名乗る・キャッシュする)を本題として扱い、練習は他人のサイトではなく自分のVMに立てた練習用ページに対してだけ行います。fetch とパースでCSVに書き出すところまでと、JavaScriptで組み立てられるページを Playwright で取るところまで。最後は「HTMLは相手の都合で変わる」前提で、壊れたときに黙って間違ったデータを出さない作りにします。
12