AIでDiátaxis構造を適用し、ドキュメントを整理する方法

エージェントがvalidate_technical_writingツールを使用し、コンテンツがチュートリアル、ハウツー、リファレンス、解説の4つのカテゴリに適合しているかを確認します。カテゴリが混ざっている箇所を特定するため、構造を修正しやすくなります。どこをどう動かすべきか、明確な内訳が提示されます。

1. 01

   意図の分析

   エージェントが原文を読み取り、それが学習、ガイド、または説明のどれに該当するかを判断します。

   validate_technical_writing
2. 02

   Diátaxis準拠の確認

   コンテンツを4つの区分と比較し、種類の混在がないかをチェックします。

   validate_technical_writing
3. 03

   構造の漏れを特定

   チュートリアルがリファレンスになろうとしている、あるいはその逆の箇所を見つけ出します。

   validate_technical_writing
4. 04

   修正リストの生成

   移動または書き換えが必要な具体的なコンテンツブロックのリストを作成します。

   validate_technical_writing

Technical Writing Prover Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcpコピー

Claude Desktop

以下の手順で数秒で接続できます。

1. 1In Claude Desktop, open Settings → Connectors.
2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3. 3Click Add and start a new chat — Technical Writing Prover capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "technical-writing-prover-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp"
    }
  }
}

• Claude
• ChatGPT
• Cursor
• VS Code
• Windsurf
• Claude Code
• JetBrains
• Cline

MCPをクライアントにリンクさせるだけです。ログイン情報は暗号化され、すぐにドキュメントの監査を開始できます。

• 01

  AIがドキュメントを書き換えてくれますか？

  いいえ。AIは構造的な問題を特定し、変更が必要な箇所を指摘しますが、実際の執筆やコンテンツの移動はユーザー自身が行う必要があります。

• 02

  既存のファイルが書き換えられることはありますか？

  いいえ。AIはフィードバックを提供するためにファイルを読み取り、分析するだけです。ドキュメントを書き込んだり上書きしたりする権限は持っていません。

• 03

  どんな形式のドキュメントでも動作しますか？

  AIクライアントが読み取り可能なMarkdownなどの標準的なテキスト形式であれば動作します。

• 04

  トーン（語り口）の修正もできますか？

  いいえ。このツールはDiátaxisの構造フレームワークを適用するためのものであり、スタイルやトーンの編集を目的としたものではありません。

• 05

  あるセクションがチュートリアルであると、どうやって判断するのですか？

  validate_technical_writingツールを使用して、コンテンツの意図がDiátaxisの各区分が持つ特性と一致するかを検証します。

• Technical Writing Proverについて他に質問がありますか？Connectorのページで回答しています。 Technical Writing Prover Connectorの全機能を見る