document-organizer

スキル概要

複数のMarkdownドキュメントに対して、一貫した構造とフォーマットを適用するためのスキル。

整理パターン

1. セクション構造の統一

• 見出しレベル: ## 数字. タイトル 形式を基本とする
• セクション番号を連続させる（例: ## 1. xxx, ## 2. xxx）
• 同レベルの情報は同じフォーマットで表現

2. フォーマット統一ルール

• 見出し: ## 数字. タイトル 形式
• 表: GitHub Flavored Markdown形式 | ヘッダー |（左寄せデフォルト）
• コードブロック: 言語指定を追加（例: ``ruby, ``javascript）
• リスト: 箇条書きは -、番号付きリストは 1. を使用
• 強調: 太字 text を適切に使用
• 箇条書き: 複数の項目を並列で説明する場合に使用

3. コンテンツ整理

• 不要なメタ情報を削除（ファイル先頭の説明文など）
• 複雑なデータは表形式に変換
• 関連する情報はまとめて配置
• 数式やコードは適切なコードブロックで囲む

実装手順

前処理

1. 対象ドキュメントを特定（globまたはユーザー指定）
2. すべてのドキュメントを読み込み、構造を分析
3. 整理パターンを適用

整理実行

1. 各ドキュメントに対し以下を実行：

- セクション番号の連番化 - 表形式データの統一フォーマット化 - コードブロックの言語指定追加 - 不要なメタ情報の削除 - 構造の明確化

1. 並列で書き込み（複数ファイルを同時に処理）

事後処理

1. 整理内容の確認（変更がないファイルの報告など）
2. 必要であれば作業記録をmemory-saverで保存

整理例

セクション番号の統一

## 整理前
- 1. xxx
- 3. yyy
- 2. zzz

## 整理後
## 1. xxx
## 2. yyy
## 3. zzz

表形式の統一

## 整理前
データ区分 | 主な取得項目 | LabCompassでの使い道
研究課題 | 課題名、予算 | 資金推移の算出

## 整理後
| データ区分 | 主な取得項目 | LabCompassでの使い道 |
|----------|------------|----------------------|
| 研究課題 | 課題名、予算 | 資金推移の算出 |

コードブロックの正規化

## 整理前

def foo end

## 整理後

def foo end

When to use me

• 「ドキュメントを整理して」と言われた時
• 複数のMarkdownファイルのフォーマットが不統一な時
• ドキュメントの可読性を向上させたい時
• プロジェクトのドキュメント標準を適用したい時