AgentSkillsCN

document-organizer

整理 Markdown 文档，统一结构与格式。对章节编号进行连续编号，统一表格格式，规范化代码块。

SKILL.md
--- frontmatter
name: document-organizer
description: Markdownドキュメントを整理し、構造とフォーマットを統一する。セクション番号の連番化、表形式の統一、コードブロックの正規化を行う。
user-invocable: true
disable-model-invocation: false
license: MIT
compatibility: opencode,claude
metadata:
  audience: 開発者
  workflow: ドキュメントメンテナンス

スキル概要

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

整理パターン

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

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

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

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

3. コンテンツ整理

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

実装手順

前処理

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

整理実行

  1. •

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

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

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

事後処理

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

整理例

セクション番号の統一

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

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

表形式の統一

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

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

コードブロックの正規化

markdown
## 整理前

def foo end

code

## 整理後
```ruby
def foo
end
code

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