AIに実装を頼むたびに、計画の粒度やテストの書き方が変わる。開発のばらつきを減らしたいなら、毎回長い指示を書く前に、共通の作業手順を整える方法があるで。
affaan-m/ECC はAIコーディング向けのスキル、ルール、フック、メモリ関連の仕組みをまとめたパッケージやで。この記事は公式READMEとライセンスを確認した紹介で、実機での性能評価やないで。
ECCでできること
AIを日常的に使う開発者や、レビューの進め方をそろえたいチームに向いてるで。ECCには計画、テストを起点にした実装、コードレビューなどの入口があり、必要なワークフローから選べるで。
対応する機能は利用するエージェントによって違うで。全部を導入すれば自動的にコード品質が上がるのやなくて、既存の開発ルールとの整合性を確認する必要があるで。
今回のゴールと環境
名前欄の入力チェックについて、実装前の計画と確認方法を作る。
確認した範囲：2026年10月24日に公式READMEや導入資料を読み直して、以下の手順を具体化したで。この改訂でアプリのインストールから最終結果までを実機で通したわけやない。成功の目安は、手元で試すときのチェックとして使ってな。
準備
ここではWindows 11 x64とPowerShellで進めるで。スタートで「PowerShell」を検索して開いてな。Node.js公式ダウンロードで24系LTS・Windows・x64のInstaller（.msi）を選び、ダウンロードしたファイルを開いて画面に沿って入れてな。入れ終わったらPowerShellを開き直すんや。
node --version
npm.cmd --version両方にバージョンが出たら準備OKや。以下ではWindowsのスクリプト実行ポリシーで止まりにくいnpm.cmdとnpx.cmdを使うで。インストール済みなら入れ直す必要はないで。
Git公式のWindows用ページからx64 Setupをダウンロードし、インストーラーの案内に沿って入れてな。PowerShellを開き直し、git --versionでバージョンが出ることを確認するんや。
今回はClaude Codeを使うで。使えるプランやAPIの支払いは別に必要やから、公式の準備・ログイン案内を先に確認してな。PowerShellで次を実行し、インストール後は新しいPowerShellを開いてな。
winget install Anthropic.ClaudeCodeWinGetがないときは、WindowsのMicrosoft Storeで「アプリ インストーラー」を入れるか更新してからやり直してな。次の確認でバージョンが出たら準備OKや。実際にclaudeを起動するんは、下の練習フォルダーを作ってからやで。初回起動は画面の案内でブラウザーにログインし、戻って入力欄が使えることを確かめてな。
claude --versionPowerShell用のコマンドと、Claude Codeの入力欄へ送る文は別やで。「Claude Codeで入力」と書いたブロックをPowerShellへ貼らんようにしてな。AIにファイルを読ませると、その内容が利用するサービスへ送られることがあるで。最初は以下の架空例だけで試そか。
New-Item -ItemType Directory -Force "$env:USERPROFILE\github-practice\ecc" | Out-Null
Set-Location "$env:USERPROFILE\github-practice\ecc"使い方
@'
<!doctype html><html lang="ja"><meta charset="utf-8"><title>練習フォーム</title><form><label>名前 <input name="name"></label><button>確認</button></form></html>
'@ | Set-Content index.html -Encoding UTF8練習用のindex.htmlを作ったで。プラグインの導入場所は次の案内を守ってな。
PowerShellで入力：
npx.cmd ecc-universal@2.2.3 setup公式のWindows向け案内に合わせ、Claude Code用にGlobal user・Standard hooksを選び、表示される変更内容を確認してから進めてな。ほかの導入方法を重ねんようにするで。
Claude Codeが開いてるときは/exitで閉じ、PowerShellで同じフォルダーからclaudeを起動し直すで。フォルダーを信頼するか聞かれたら、今作った練習用の場所か確認してな。
Claude Codeで入力：
/ecc:plan index.htmlの名前欄を必須にしたい。空のときは送信せず説明を出し、入力済みなら確認できるようにする。まず変更箇所と確認手順を計画して。まだ実装せんといて。成功の目安：計画に、空欄・入力済み・エラー表示の確認が含まれることや。/plugin listでecc@eccが有効かも確かめてな。
仕組みとデータの流れ
トラブルシューティング
| 困ったこと | 確認すること |
|---|---|
| 導入した機能が出ない | Claude Codeを再起動し、導入時に選んだ対象と保存先を確認してな。/pluginで使うプラグインの状態も確認するんや。 |
| 想定外のファイルを変えようとする | 実行前の提案を読み、練習フォルダーだけに対象を絞ってな。既存の仕事用ファイルにはそのまま適用せんといてな。 |
終了と再開
Claude Codeは入力中ならEscで作業を止め、/exitで終了できるで。続けるときは同じ練習フォルダーでclaudeを実行するんや。保存したHTMLはエクスプローラーからダブルクリックして表示を確認してな。
公式READMEと最新の導入案内も確認してな。配布版や外部サービスの変更で、手順が変わることがあるで。
計画と検証
例えば必須入力の検証なら、正常入力だけでなく、空欄や空白だけの値の扱いを最初に決めてな。AIの提案をそのまま採用するより、成功条件を共有することが重要やで。
| これまでの作業 | 導入後に目指せる進め方 |
|---|---|
| 実装後になって、確認すべきケースを思い出す。 | 計画と成功条件を先に共有し、変更後に同じ観点で確認する。 |
フックとルールの注意点
フックやツール連携にはコマンド実行や外部接続を伴うことがあるで。提供元、設定差分、実行権限を確認し、既存のルールやプラグインとの競合を避けるで。
導入後は、利用できるコマンドが一つずつ存在するか、意図しない二重実行がないか、実際の変更でテストとレビューが機能するかを確認してな。掲載される性能や効率の数値は、この記事では独立に検証してへんで。
公式資料と利用条件
ECC本体はMITライセンスやで。接続先モデルや外部サービスの費用・利用条件は別に確認してな。
確認日：2026年10月23日。本文は公式情報をもとに独自に構成し、図解は本記事用に制作したで。公式の画像・動画やREADMEの長文転載は使ってへんで。記事中の利用例・改善の比較は想定例であり、性能や成果の保証やないで。