
Claude Haikuに「計算」をさせない—音読コーチの二段構え設計とプロンプトの沼
Zenn音読速度計測アプリで Claude Haiku を使ったコーチング機能を実装する際、計算とルール判定はコード側で完結させ、Haiku には言語化だけを担当させる「二段構え」設計を解説。システムプロンプト・API 実装・プロンプトキャッシュの検証結果、実データで確認した予想外の挙動までをまとめた開発記。
全 1575 件 (Zenn で絞り込み) · 45 / 79 ページ

音読速度計測アプリで Claude Haiku を使ったコーチング機能を実装する際、計算とルール判定はコード側で完結させ、Haiku には言語化だけを担当させる「二段構え」設計を解説。システムプロンプト・API 実装・プロンプトキャッシュの検証結果、実データで確認した予想外の挙動までをまとめた開発記。

約1,591行のシステムプロンプト (CLAUDE-FABLE-5.md) を解析したエンジニアリングレポート。振る舞いポリシー、世界モデル、ルーター、ハード制約、ツール定義の5層構成として、単なる「プロンプト」ではなく「運用仕様書」として機能していることを指摘。ファイルパスの役割固定化、Skillファースト、検索・Artifact・会話の使い分け基準などが具体的に記述されており、エージェント設計時の方針決定とスキーマ定義の分離が参考になる。


anthropic SDK 0.39.0を固定していても、間接依存のhttpx 0.28で proxies 引数が廃止されたため、デプロイ再ビルド時にClient初期化エラーが発生。requirements.txtでhttpxバージョンも明示的に固定することで解決。直接依存だけでなく重要な間接依存のピン留めが必須。




Claude Code の ~/.claude 配下にある設定・メモリ・セッション・プラグイン・キャッシュ各ファイルの役割・形式・ライフサイクルを実データに基づいて解説。ローカル環境での Claude Code の動作メカニズムを理解し、設定やキャッシュの手動管理が可能になる。

Claude Code で作成したスキルが自動で呼び出されない原因は、スキルの実装ではなく description の書き方にある。本文 + トリガー語リストの二段構えで description を整備し、実際の言い回しに近い検索キーワードを含めることで呼び出し率が向上する一方、汎用語を盛りすぎると暴発するため、相互参照で似たスキル同士の棲み分けを明記する必要がある。

複数エージェントに役割を分担させるマルチエージェント体制(Orchestrator / Planner / Worker / Critic)を Claude Code プラグインとして実装。前半は対話的な Agent Teams で「何を作るか」を決め、後半は決定論的な Workflow で実装→検証を並列実行する。実装・検証役を分離する Critic ゲートが精度向上の鍵。


非公開の社内 Qiita に Claude がアクセスできるよう、qiita-kamo という CLI ツールを開発した。grep・read・search・tag 等のコマンドで記事検索・閲覧が可能になり、Claude Code を使った作業時に既存ナレッジを先に参照するフロー を実現。

Claude Desktop のデスクトップ版から スマホアプリへの Remote 接続が動作しない理由を、実際の操作画面をもとに解説。トグル設定の見落としと「対話が発生しないとノードが形成されない」という仕様が主な原因で、設定 → セッション作成 → メッセージ送信の順序を守ることで接続可能。


個人開発の複式簿記家計簿アプリ「黒福簿」に、ユーザーだけが鍵を保持するゼロ知識E2E暗号化を実装。サーバー側で暗号文のみ保管し、運営者でもデータを復号できない設計にした。実装プロセスと「手間ゼロ+完全暗号化」が両立しない理由、暗号化キー管理の実装パターンを詳述。

YouTube Liveのコメントを「世論」として解析し、経済・治安など13の指標がリアルタイムで変動する架空国家シミュレータ「AInation」を開発。OpenAI APIとClaude Codeを活用して1.5人日で完成させ、AIへの指示工夫(「スクロール不可」より「画面外は見えない」が有効)が課題だった。



Claude Code の Hooks 機能を使い、CLAUDE.md での「お願い」を決定論的な実行に変える方法を解説。SessionStart / UserPromptSubmit / PreToolUse など複数のイベントレベルで、prettier の自動実行や危険なコマンドのブロックを Claude の判断に関わらず強制できる。settings.json による設定方法と 5 つの実践パターンを紹介。

Claude Code でセッションをまたぐと学習が失われる課題を解決する Agent Skill「self-improvement」を紹介。エージェントが訂正・エラー・知識ギャップを検知すると .learnings/ ディレクトリに構造化して記録し、コミットでチーム全員に共有できる仕組み。繰り返し学びは恒久ルールへ昇格させることで、個人の経験がチーム資産になる。