Home ja

LockedIn CLI — AIエージェントと一緒に開発するための、ふざけたチュートリアル

🌎 言語: 日本語 — 33言語すべてを見る

ようこそ。このwikiは、エージェント型のAIコーディングアシスタントと一緒に 本物のコマンドラインツールを作るための、手を動かして学ぶ入門チュートリアルです。 題材がとにかくくだらないので、楽しく学べます。

題材は LockedIn CLI。AI時代の開発者ツールと、プロフェッショナルSNSの「意識高い系 ソートリーダーシップ」を同時にパロディした、ニセの「AI CLI」です。グラデーションの スプラッシュ、対話型のチャットセッション、スラッシュコマンド、そして一生懸命 「思考する」モデル——それでいて、実用的な価値はきっちりゼロ。もちろん狙ってやっています。

とはいえ冗談の下にあるのは、依存パッケージゼロ・テスト完備の、学習にちょうどいい Node.jsプロジェクトです。

ふざけた題材こそ教材です。 転職スカウトまみれの受信箱に笑いながら、 設計・テスト、そして何より AIエージェントに実際のコードを書かせ、 変更させるための指示の出し方 が身につきます。

---

こんな人向けです

• AI支援・エージェント型のコーディングがはじめての人。 チャット型のアシスタントは 使ったことがあっても、ファイルを編集し、テストを実行し、変更をコミットまで進める 「エージェント」はまだ、という段階を想定しています。そこはゆっくり進みます。
• プログラミングの基礎はある人。 JavaScriptが読めて、ターミナルが使えて、 関数の流れを追える程度でOKです。コードは中級、AIの部分は初級という配分です。 （フレームワークの知識は不要。依存パッケージゼロの素のNodeだけです。）

エージェント機能を持つアシスタントなら何でも構いません。例では GitHub Copilot CLI（このプロジェクトを書いた張本人）を使いますが、 進め方は他のエージェントにもそのまま応用できます。

唯一のルール、テストゲート 🧪

このプロジェクトには絶対のルールがあり、チュートリアル全体がその周りを回っています。

npm test が通らないものは、絶対にマージしない。

AIエージェントは、とにかく速く大量のコードを書きます。その出力を 自分のコントロール下に置くための装置が、この検証スイートです。 このチュートリアルでは、エージェントに テストゲートの内側で 仕事をさせる ——変更内容を伝え、テストを書かせ、実装させ、スイートが緑になってはじめて受け入れる ——という進め方を身につけます。

このチュートリアルの使い方

章は順番に進めてください。どれも短く、最後に 「エージェントと試してみよう」 の演習があり、前の章の内容の上に積み上がっていきます。

1. チュートリアル1 オリエンテーション — プロジェクトを動かし、エージェントと顔合わせをして、テストゲートを初めて回します。
2. チュートリアル2 コードのしくみ — このプロジェクトがなぜエージェントにとって変更しやすく、そして安全なのか。 純粋でテストしやすいコア、シード付きの乱数、そしてテストスイートの話です。
3. チュートリアル3 はじめてのエージェントタスク — 本題です。エージェントに指示して、新しいコマンドを最初から最後まで、 テストファーストで追加します。
4. チュートリアル4 プロンプトとレビュー — リードエンジニアのようにプロンプトを書き、差分をレビューし、うまくいかないときに 立て直し、セッションをまたいで勢いを保つ方法。
5. チュートリアル5 多言語対応 — このCLIが33言語を話すしくみと、さらに別の言語をエージェントに追加させる方法 （i18n、キーの一致、全角と結合記号のレイアウト）。

作中設定のネタ資料が読みたい人は コマンドリファレンス（元祖・風刺「マニュアル」）へ。 支援技術を使っている人は アクセシビリティ を参照してください。 スクリーンリーダー、ハイコントラスト、低刺激の各モードがあります。

コーディングエージェントを使って貢献する

コントリビューションを歓迎します。リポジトリをクローンし、Claude Code、Cursor、 Codexなど、任意のコーディングエージェントでローカルの作業ツリーを開いてください。 リポジトリ内の指示とこのチュートリアルに従うようエージェントへ伝え、変更内容を確認し、 提出前に npm test を実行してください。これらは単なる例であり、公認や組み込み連携を 意味するものではありません。

---

前提条件

• Node.js 18以降（Linux / macOS / Windows。どれでも動作は同じです）。
• git と、エージェント機能のあるコーディングアシスタント（例: GitHub Copilot CLI）。
• 30〜60分ほどの時間と、笑う準備。

準備はいいですか？ では チュートリアル1 オリエンテーション へ。

---

_{風刺作品です。 LockedIn CLIは、AI時代のコマンドラインツールと 「ソートリーダーシップ」文化のパロディであり、LinkedInをはじめとする実在の企業とは 一切関係がなく、公認でも、それらを代表するものでもありません。 大規模言語モデル（GitHub Copilot CLI、Claude Opus 4.8）が人間の指示のもとで執筆し、 GPL-3.0-or-later でライセンスされています。詳しい免責事項は lockedin legal を実行してください。}