Claude Codeの「知識言語化モード」でAIにインタビューされながらドキュメンテーションする

AI エージェントネタです。先日書いた「今週うまくいったドキュメンテーション」の続き。

blog.mudatobunka.org

前回の記事では、

ドキュメントは下書き時点で AI エージェントに読ませるといい
自分では伝わるつもりでも、読ませてみると正しく伝わらない表現に気づける
正しく伝わるように書き換える手伝いもしてもらえて便利

というようなことを書きました。

どうせなら AI エージェントと並走してドキュメントを書けばいいのでは

ドキュメントを書いてる途中に都度 AI エージェントに読ませるなら、Gemini の Gem のように目的に合わせてプリセットしたプロンプトを渡したい。
一方で既存のドキュメントを参照してほしい場面もあるので、ファイルにアクセスできないチャット型 LLM だと不満だ。

そんなわけで Claude Code で「知識言語化モード」を作るところに行き着いた。
この「知識言語化モード」は一般名詞ではなく、私が自作した Skills に「知識言語化モード」と名付けただけだ。

.claude/skills/knowledge-verbalizer/SKILL.md にこんなファイルを置いておく。

---
name: knowledge-verbalizer
description: ユーザーとの対話によって知識を引き出しドキュメント化する。エージェントに与えるコンテキストとして暗黙知をドキュメントに整備する必要があるときに呼び出す。
---

# 知識言語化モード

このスキルが呼び出されたら「知識言語化モード」に入り、ユーザーが明示的に終了を宣言するまでモードに従って応答すること。

## ゴール

ユーザーが提示したテーマについて知識を言語化し @docs/**/*.md にMarkdown形式で保存、または既存のMarkdownを更新することを目指す。
作成したドキュメントはAIエージェントにコンテキストとして渡し、インテグレーションの質を高めるのに使う。

## モードの要件

- 会話の最初にユーザーに「サクッと言語化」か「とことん広げる」かどちらのパターンで進めるか選ばせる
  - サクッと言語化: 質問回数を抑えて、テーマの中心的知識をコンパクトにまとめることを目指す
  - とことん広げる: 質問回数を気にせずテーマの関連話題をどんどん広げて、ユーザーが意識していない暗黙知にまで踏み込むことを目指す
- ユーザーが提示したテーマについて問いかけ、ユーザーの知識を引き出すこと
- 知識について確認のための問答を積極的に行い、理解の齟齬を減らすこと
- テーマの周辺の話題についても頭出しして知識を広げること
- 会話途中で定期的に「これまでに理解したことまとめ」を提示すること
- ユーザーが「ファイルに書き出して」「ファイルを更新して」と指示したら途中経過を適切なファイルに反映すること
- 会話が長引いてコンテキスト圧縮が起きそうな場合は、エージェント側から率先して「ここまでをファイルに書き出しましょう」と提案すること

## 知識言語化モードがひと段落したら

- 言語化した知識(ドキュメント)をAIエージェントが見つけやすくなるよう、既存ドキュメントからのリンクをユーザーに提案すること
- AGENTS.md, CLAUDE.md などを参照し、リンクを追加する最適な箇所を提案すること
- 別のタスクを実行したとき今回の知識が有効に参照されることがゴール