概要
Claude Codeのhook機能を活用し、textlintによる自動検出とLLMによる修正を組み合わせた、日本語ドキュメントの品質向上フィードバックループの設計手法を解説。
詳細内容
Claude Codeの`PostToolUse` hookを利用して、Markdownの記述内容を自動で検査・修正させるワークフローの構築方法を解説しています。主な構成は以下の通りです。
### 1. hookによる強制フィードバック
`PostToolUse`で`decision: "block"`を返すことで、モデルの判断を介さず「修正が必要である」という事実を確実にモデルへ届け、修正ループを回します。
### 2. 検出と修正の分離設計
検出（いつ直すか）は決定論的なtextlintが行い、修正（どう直すか）は文脈を考慮できるClaude本体（meisekiスキル）が担当する役割分担を採用。これにより、hook内で再度LLMを呼ぶコストと再帰の複雑さを回避しています。
### 3. 実装の安全弁と運用
無限ループを防ぐための回数制限、オフライン時などのフェイルオープン設計、環境変数による脱出ハッチなど、自動化に伴う暴走を防ぐ実戦的なTipsが紹介されています。指示（CLAUDE.md）だけでは徹底できない記述ルールをシステムの仕組みとして強制できる点が強力です。