anytime-markdown-check

name	anytime-markdown-check
effort	low
description	Markdown ファイル出力後の検証。機械的な整形（空行・インデント・テーブルパイプ等）は format_markdown に委譲し、本スキルは自動化できない意味判断（コードスパン・引用・図解・ハードブレーク・階層再設計）のみを扱う。Markdown ドキュメントを出力・更新した後の検証時に使用する。

---

path: "**/*.md"

Markdown 出力検証

更新日: 2026-07-04

ファイル出力後、(1) 機械的整形を format_markdown で適用し、(2) 自動化できない意味判断を以下のチェックリストで確認する。

---

1. 機械的整形（format_markdown に委譲）

見出し前後の空行（上1・下1）・箇条書き/テーブル/引用の前後空行・連続空行の圧縮（最大2）・インデントのタブ→4スペース・行末空白除去・テーブルセル内コードスパンのパイプエスケープは format_markdown が決定論的に自動修正する。手動で確認・修正しない。

• mcp-markdown の format_markdown(path, mode="fix") を実行する（ルート外のファイルや MCP 非利用時は bash ~/.claude/scripts/validate-markdown.sh <出力ファイル> をフォールバックに使う）
• 返り値の warnings を確認する（下記「3. 構造」の自動修正されない項目に対応）

format_markdown は対象 MCP サーバーのルート配下の .md のみ操作する。ルート外（別リポジトリ等）は届かないため、その場合のみ手動または validate-markdown.sh で確認する。

2. 構文・記法（意味判断・手動）

format_markdown では判定できない。文意を読んで確認する。

• 変数名、ファイル名、ボタン名、テーブル名等のシステム固有名称がコードスパン（`）で囲まれているか
• 補足情報が引用ブロック（>）で本文と分離されているか
• 複雑なロジックが Mermaid 図で図解されているか（該当する場合）
• 「。」の後に文章が続く場合、意図通りのハードブレーク／段落分けになっているか（format_markdown は hardBreakAfterPeriod で警告するのみ・自動修正しない）
• コードスパン内のバックスラッシュが不要にエスケープされていないか（リテラル扱い）

3. 構造（手動・再設計が必要）

機械的には修正できない。format_markdown は警告のみ。

• 箇条書きの深さが2階層以内か（超える場合は子見出しで再設計。format_markdown は nestDepth で警告するのみ）
• Markdown 記法文字がテーブルセルを壊していないか