Tech Notes#

技術仕様・Tips・検証メモ

特定の技術に関する小さな発見や設定ノウハウをまとめた、辞書的なカテゴリです。必要な項目だけを拾い読みしてください。

14 件のエントリ

実装言語を選ぶ前に環境前提を確認する

実装言語やランタイムを決める際、前提となる CLI やライブラリがターゲット環境に存在することを事前確認する（preflight check）。「いつもの環境にはあるから」という感覚で選ぶと詰む。具…
LLM API キーの管理と漏洩防止

LLM の API キー（OpenAI, Anthropic 等）は高価・攻撃対象・漏洩時の影響が大きい。最初から管理の仕組みを整えないと、事故を起こす。漏洩の主な経路基本の守り方 1. 環境変数…
LLM 機能を本番リリースする前のチェックリスト

LLM を組み込んだ機能を本番にリリースする前に、従来のアプリと違う観点でチェックする項目がある。見落とすと、本番で想定外の事故を起こす。リリース前チェックの構造カテゴリ別チェックリスト評価 -…
AI エージェント運用の 10 メトリクス

AI エージェントを本番運用する際、何を計測すべきかが曖昧だと改善できない。重要な 10 のメトリクスを 4 層で整理。メトリクスの 4 層品質層 1. 正答率（Accuracy）評価セットでの…
LLM アプリのインシデント対応

LLM アプリでインシデントが発生したときの初動対応を、事前に決めておく。インシデントの種類ごとに異なる対応手順を持つのが鉄則。インシデントの分類共通の初動フロー 1. 検知: アラート or ユ…
OpenAI と Anthropic API の主要差分

OpenAI API と Anthropic API は多くの概念が共通するが、細かな仕様差がある。両方を扱う実装で引っかかるポイントを整理。主要な差分マップ API 構造の違いメッセージとシステ…
Claude Code の Slash Command と Skill の使い分け

Claude Code にはで呼び出す Slash Command と、自然言語で起動される Skill がある。名前は似ているが役割も実装も違う。正しく使い分けると運用効率が大きく変わる。違いの…
SQLite FTS5 で日本語を全文検索する

SQLite FTS5 のデフォルト tokenizer ( ) は日本語の分かち書きを行わず、「テスト」のようなクエリでは期待通りの結果が得られない。SQLite 3.34 以降で利用できる tri…
SQLite FTS5 クエリは phrase 化して安全に渡す

FTS5 のクエリ構文ではなどが演算子として解釈される。ユーザー入力をそのまま渡すとクエリエラーや意図しない検索結果を招く。たとえばはと解釈される。対策 1. デフォルトは全クエリを phra…
Edge Runtime vs Node Runtime の使い分け

Vercel（や Cloudflare Workers）の Edge Runtime は起動が速くグローバル分散できるが、Node.js API の大半が使えない。Node Runtime との使い分…
LLM API のレート制限との付き合い方

LLM API（OpenAI・Anthropic 等）のレート制限は、負荷時に必ず遭遇する。事前にリトライ戦略・バックオフ・キューを組み込んでおかないと、本番で落ちる。主なレート制限の種類 - RP…
LLM アプリのログ設計で残すべき 5 項目

LLM を組み込んだアプリは、従来のアプリよりログ設計が重要。非決定的な応答・高コスト・予測不能な失敗を相手にするため、何が起きたかを後から再現できないと改善が進まない。記録すべき 5 項目 1.…
ナレッジベースのファイル命名規則とテキスト規約

個人・チームでナレッジを運用する際、命名規則とコンテンツルールを先に決めておくと、検索性と整合性が保てる。Dinekt で実運用している規約を一般化した例。ファイル命名 TODO 形式コンテンツル…
chrome.storage は local / sync / session を正しく使い分ける

Chrome 拡張で状態を保存する際、とのどちらを使うかは意外と間違えやすい。誤ってを選ぶと、クォータ制限にすぐ引っかかる。違いを 1 図でクォータ比較使い分けの目安 - ユーザー設定・フ…