Output Formatter

出力フォーマッター

出力フォーマッターのスキルは、AI が生成したコンテンツを、特定の状況に適した形式に変換します。ドキュメント用の Markdown、API 用の JSON、分析用の表、プレゼンテーション用の文章など、出力を適切かつ一貫した構成に整えます。

このスキルは、さまざまなプラットフォーム（GitHub、Notion、Slack、メール）、用途（技術文書、ユーザーガイド、レポート、コードコメント）、対象読者（開発者、関係者、エンドユーザー）における形式要件を理解しています。手作業での再フォーマットを減らし、プロフェッショナルで一貫性のある見せ方を実現します。

AI の出力を特定のプラットフォーム向けに変換する場合、既存のドキュメントに組み込む場合、または特定の対象読者に向けて提示する場合は、このスキルを使用してください。

主なワークフロー

ワークフロー 1：形式間の変換

1. 特定：ソース形式を確認します。
   • 現在の構成
   • コンテンツの種類
   • データの階層
2. 把握：出力先の形式要件を理解します。
   • プラットフォームの制約
   • 構文ルール
   • 慣習
3. 対応付け：コンテンツの構成を対応させます。
   • 見出し → 相当する要素
   • リスト → 適切な形式
   • コードブロック → 正しい構文
   • リンク → プラットフォーム固有の形式
4. 変換：コンテンツを変換します。
   • 意味を維持する
   • 出力先の構文に合わせる
   • 読みやすさを保つ
5. 検証：出力を確認します。
   • 構文の正確さ
   • 完全性
   • 見た目の一貫性
6. 提示：整形した結果を提示します。

ワークフロー 2：特定のプラットフォーム向けの形式設定

1. 特定：出力先のプラットフォームを確認します。
   • GitHub（Markdown）
   • Notion（ブロック）
   • Slack（mrkdwn）
   • メール（HTML／プレーンテキスト）
   • Confluence（Wiki）
   • Jira（マークアップ）
2. 適用：プラットフォーム固有の慣習を適用します。
   • 構文の違い
   • 対応機能
   • ベストプラクティス
   • 制限事項
3. 最適化：プラットフォームに合わせて最適化します。
   • プラットフォーム固有の機能を使う
   • 文字数制限を守る
   • 適切な書式を追加する
4. テスト：可能であれば、レンダリングを確認します。
5. 提示：すぐに貼り付けて使える出力を提示します。

ワークフロー 3：プレゼンテーション用のデータ構成

1. 分析：データの内容を分析します。
   • 情報の種類
   • 関係性
   • 重要度の階層
2. 選択：最適な構成を選びます。
   • 比較には表
   • 順序にはリスト
   • 階層にはツリー
   • 関係性にはグラフ
3. 整形：適切に整形します。
   • わかりやすい見出し
   • 一貫した配置
   • 適切な入れ子構造
   • 視覚的な階層
4. 追加：コンテキストを加えます。
   • タイトル／キャプション
   • 列の説明
   • 単位／尺度
   • 必要に応じて脚注
5. 検証：読みやすさを確認します。

ワークフロー 4：対象読者に合わせた調整

1. 特定：対象読者を確認します。
   • 技術的な専門知識のレベル
   • 分野の知識
   • 役割／責任
   • 背景／目標
2. 調整：コンテンツを適切に調整します。
   • 技術的な深さ
   • 専門用語の使用
   • 詳細度
   • 選ぶ例
3. 再構成：明確さを高めるために構成を変えます。
   • 経営層向けのエグゼクティブサマリー
   • 実装担当者向けの詳細
   • 初心者向けの背景情報
4. 整形：期待される形式に合わせます。
   • ビジネス向け：図表と要約
   • 技術者向け：コードと図
   • ユーザー向け：簡潔で明確
5. 確認：適切な内容になっているか見直します。

クイックリファレンス

アクション	コマンド／トリガー
Markdown に変換	"Format as markdown"
JSON に変換	"Format as JSON"
表に変換	"Format as table"
GitHub 向けに整形	"Format for GitHub"
Notion 向けに整形	"Format for Notion"
Slack 向けに整形	"Format for Slack"
技術的な内容にする	"Format for developers"
技術者以外向けにする	"Format for stakeholders"
要約を作成	"Format as executive summary"

ベストプラクティス

• 意味を保つ：変換中に情報を失わないようにします

  • 実質的な内容をすべて保持します
  • 論理的な構成を維持します
  • 関係性と文脈を保ちます

• 慣例に従う：形式ごとのベストプラクティスを使用します

  • Markdown：ATX 形式の見出し、フェンス付きコードブロック
  • JSON：適切なエスケープ、一貫したインデント
  • 表：列を揃え、見出しを明確にします

• 読みやすさを最適化する：人が読みやすい形式に整えます

  • 余白を効果的に使います
  • 長いセクションを分割します
  • 視覚的な階層を加えます
  • 文脈を把握する手がかりを含めます

• 出力を検証する：形式が正しいことを確認します

  • 可能であればパーサーでテストします
  • レンダリングのプレビューを確認します
  • 構文ハイライトを検証します

• 一貫性を保つ：スタイルを統一します

  • 同じ重要度には同じ見出しレベルを使います
  • リストの書式を統一します
  • コードブロックの言語を統一します
  • 用語を標準化します

• 文脈を考慮する：用途に合わせて適切な形式にします

  • ドキュメント：明確で、詳細かつ構造化された内容
  • コミュニケーション：簡潔で、把握しやすく、実行に移せる内容
  • コード：適切なコメントと構文ハイライト
  • レポート：データが豊富で、視覚的に分かりやすく、要約された内容

形式テンプレート

Markdown ドキュメント

# Main Title

## Overview
Brief introduction to the topic.

## Key Concepts
- **Concept 1**: Description
- **Concept 2**: Description

## Usage
\`\`\`language
code example
\`\`\`

## Reference
| Parameter | Type | Description |
|-----------|------|-------------|
| param1 | string | What it does |

JSON API レスポンス

{
  "status": "success",
  "data": {
    "items": [],
    "pagination": {
      "page": 1,
      "totalPages": 10,
      "totalItems": 100
    }
  },
  "metadata": {
    "timestamp": "2026-01-06T00:00:00Z",
    "version": "1.0"
  }
}

比較表

| Feature | Option A | Option B | Option C |
|---------|----------|----------|----------|
| Speed | Fast | Medium | Slow |
| Cost | High | Medium | Low |
| Ease | Easy | Medium | Complex |
| **Recommend** | ✓ | | |

エグゼクティブサマリー

## Executive Summary

**Objective**: [One-line goal]

**Status**: [Current state]

**Key Results**:
- Result 1
- Result 2
- Result 3

**Next Steps**:
1. Action item 1
2. Action item 2

**Blockers**: [Issues requiring escalation]

技術仕様

## [Component Name]

**Purpose**: [What it does]

**Dependencies**: [What it requires]

**Interface**:
\`\`\`typescript
interface ComponentProps {
  prop1: string;
  prop2?: number;
}
\`\`\`

**Behavior**:
1. Step-by-step description

**Error Handling**:
- Error type: Response

**Examples**:
\`\`\`typescript
// Usage example
\`\`\`

Slack メッセージ

*Project Update* :rocket:

*Status*: On track
*Completed*:
• Feature A deployed
• Bug fixes merged

*Next*:
• Feature B review
• Performance testing

*Blockers*: None

<link|Full details>

形式変換ガイド

散文からリストへ

変換前：「このシステムは、OAuth、API キー、セッショントークンによる認証に対応しています。また、ロールベースのアクセス制御も提供します。」

変換後：

## Authentication Methods
- OAuth 2.0
- API Keys
- Session Tokens

## Authorization
- Role-based Access Control (RBAC)

リストから表へ

変換前：

- JavaScript: 45%
- TypeScript: 30%
- CSS: 15%
- HTML: 10%

変換後：

| Language | Percentage |
|----------|------------|
| JavaScript | 45% |
| TypeScript | 30% |
| CSS | 15% |
| HTML | 10% |

コードからドキュメントへ

変換前：

function processData(input: string[], options?: ProcessOptions): Result

変換後：

### processData

Processes input data according to specified options.

**Parameters**:
- `input` (string[]): Array of strings to process
- `options` (ProcessOptions, optional): Configuration object

**Returns**: `Result` - Processed data result

**Example**:
\`\`\`typescript
const result = processData(['a', 'b', 'c'], { sort: true });
\`\`\`

プラットフォーム固有の書式設定

GitHub Markdown

• コードの変更には diff 構文を使用します
• 注釈には [!NOTE] を使用します
• 折りたたみ可能なセクションには <details> を使用します
• 絵文字は控えめに使用します（:rocket:）
• 課題や PR には #123 でリンクします

Notion

• 長いコンテンツにはトグルブロックを使用します
• 重要な情報にはコールアウトブロックを使用します
• 構造化データにはデータベースビューを使用します
• 比較には 2 列レイアウトを使用します

Slack

• *太字* と _斜体_ を使用します
• 引用には > を使用します
• コードブロックには ``` を使用します
• メッセージは要点を把握しやすくします
• 詳細はスレッドを使用します
• 視覚的な手がかりとして絵文字を追加します

メール

• プレーンテキストまたはシンプルな HTML を使用します
• 段落は短くします
• 件名を明確にします
• 冒頭に要約を含めます
• CTA を分かりやすくします

対象読者に合わせた調整

経営幹部向け

• 影響と成果を最初に伝えます
• ビジネス指標を使用します
• 専門用語を最小限に抑えます
• 図表などのビジュアルを含めます
• 明確な提案を示します
• 簡潔にまとめます

開発者向け

• 技術的な詳細を含めます
• コード例を示します
• 関連ドキュメントへのリンクを付けます
• アーキテクチャ上の判断について説明します
• 再現手順を示します
• 用語を正確に使います

エンドユーザー向け

• 分かりやすい言葉を使います
• スクリーンショットやビジュアルを含めます
• 手順を順を追って説明します
• 「方法」だけでなく「理由」も説明します
• 想定される質問に先回りして答えます
• サポートリソースを案内します

ステークホルダー向け

• 進捗とスケジュールに焦点を当てます
• リスクとその軽減策を強調します
• ビジネス目標とのつながりを示します
• 指標とデータを使用します
• 選択肢と提案を提示します
• 課題について率直に伝えます