tomevault-io 変更のあったドキュメントの品質を体系的にチェック・修正する。
PHASE 1: .dodo.yaml カバレッジチェック
新規ファイルの特定:
git diff --name-status mainで新規追加されたMarkdownファイル（ステータス "A"）を抽出する.md,.mdx拡張子でフィルタする
.dodo.yaml の読み取り:
.dodo.yamlを読み、pagesセクションの構成を把握する- 明示的に定義されたMarkdownファイル（例：
markdown: "README.md"）を抽出する - matchパターン（例：
match: "/notes/*"）を抽出する
カバレッジの検証:
- 新規Markdownファイルごとに:
- pagesセクションに明示的に登録されているか確認
- またはmatchパターンに一致するか確認
- どちらにも該当しないファイルを報告する
- 未登録ファイルがある場合:
- 追加すべきエントリやパターンを提案する
- 新規Markdownファイルごとに:
PHASE 2: Markdownファイルの品質チェック
変更ファイルの特定:
- mainブランチから変更されたMarkdownファイルを特定する
各ファイルに対して:
a. フロントマターの検証:
- フロントマター（
---で囲まれたYAML）の有無を確認 - フロントマターがない場合:
- 必須フィールドを生成して追加する:
title: 最初の見出しまたはファイル名から抽出path: ファイル名から生成（拡張子除去、小文字化、スペースをハイフンに）description: 最初の段落から抽出
- 必須フィールドを生成して追加する:
- フロントマターがある場合:
- 必須フィールド（title, path, description）の有無を確認
- 不足しているフィールドを補完
- タイトルがドキュメント内容と一致しているか確認
b. 誤字脱字の検出:
- ファイル全体を読み通す
- チェック項目:
- スペルミス（技術用語と区別する）
- 文法の誤り
- 句読点の誤り
- Markdown構文のエラー
- コードブロック、技術用語、固有名詞は保持する
- 修正は即座に適用する
- フロントマター（
PHASE 3: dodo check による検証
dodo checkを実行する- エラーがあれば原因を特定し修正する
- 修正後に再度
dodo checkを実行し、エラーが解消されたことを確認する - エラーがなくなるまで繰り返す
品質基準
- 正確性最優先: 修正で新たなエラーを生まない
- 文脈を理解: ドキュメントの目的を理解してからタイトルを変更する
- フロントマターの完全性: すべてのMarkdownファイルに必須フィールドがあること
- 徹底的に: 変更ファイルのすべての単語を読む
- 非破壊的: フォーマット、コードブロック、意図的なスタイルを保持する
出力
以下を含むレポートを出力する：
- .dodo.yamlカバレッジ:
- 新規Markdownファイルの一覧と登録状況
- 未登録ファイルへの具体的な提案
- レビューしたファイルの一覧
- ファイルごとの修正内容:
- フロントマターの状態と追加・更新したフィールド
- 修正した誤字脱字の数と一覧
dodo checkの結果と適用した修正- 全体の統計（チェックしたファイル数、検出した問題数、修正した問題数）
Converted and distributed by TomeVault — claim your Tome and manage your conversions.