AgentSkillsCN

blog-format

将论文分析报告改写为引人入胜的技术博客形式。当用户希望将学术报告转化为更通俗易懂、面向更广泛受众的博客文章时,可使用此功能。

SKILL.md
--- frontmatter
name: blog-format
description: Rewrites paper analysis reports into engaging tech blog format. Use when the user wants to convert an academic report to a blog post style that's accessible to a wider audience.

テックブログ形式変換スキル

論文分析レポートを、一般の技術者向けのテックブログ形式に書き換えます。

重要な原則

このスキルは「形式と構造」のみを変換します。内容の削減は行いません。

文体は必ず「ですます調」「丁寧語」で統一してください。

変換する変換しない
文体(である調 → ですます調・丁寧語)技術的詳細
構造(セクション配置)図表(すべて保持)
見出し(キャッチーに)数式・アルゴリズム
導入部(読者を引き込む)実験結果・数値
参照論文の詳細
リンク・URL

変換の基本方針

必ず保持するもの

  1. すべての図表

    • 元レポートの ![Figure X](path) をすべて保持
    • キャプションも維持
    • 図表の解説も残す
  2. すべての技術的詳細

    • 数式(LaTeX形式のまま)
    • アルゴリズム・擬似コード
    • アーキテクチャの説明
    • 各コンポーネントの詳細
  3. すべての実験情報

    • データセット詳細
    • 評価指標
    • ベースライン手法
    • 結果テーブル(完全に転記)
    • アブレーション研究
  4. すべての参照論文

    • 各論文の詳細情報
    • 概要・貢献・手法
    • 本論文との関係
    • URLリンク
  5. すべてのリンク・URL

    • arXiv リンク
    • GitHub リンク
    • プロジェクトページ
    • 参照論文へのリンク

変換するもの

  1. 文体(必須: ですます調・丁寧語)

    • すべての文を「ですます調」で統一する
    • 丁寧語を使用し、読者に敬意を払った文体にする
    • 「〜である」→「〜です」
    • 「〜だ」→「〜です」
    • 「〜する」→「〜します」
    • 「〜できる」→「〜できます」
    • 「〜ない」→「〜ありません」「〜ません」
    • 「本論文では」→「この研究では」
    • より口語的で親しみやすく、かつ丁寧に
  2. 構造・見出し

    • セクション配置をブログ向けに
    • 見出しをキャッチーに
    • TL;DR を冒頭に追加
  3. 導入部

    • 読者が共感できる問題提起
    • 「あるある」から始める

ワークフロー

1. 対象レポートの特定

ユーザーが指定したレポートを読み込みます。

bash
ls -lt reports/*.md | head -5

2. 元レポートの完全な読み取り

すべての内容を抽出

  • 基本情報
  • すべての図表とそのパス
  • すべてのセクション内容
  • すべての表
  • すべての数式
  • すべての参照論文詳細
  • すべてのリンク

3. ブログ形式への再構成

内容を削減せず、構造と文体のみ変換。


テックブログのテンプレート(研究論文用)

markdown
# [キャッチーなタイトル]

> [論文タイトル] を詳しく解説します

| 項目 | 内容 |
|------|------|
| **論文** | [タイトル] |
| **著者** | [著者名] |
| **arXiv** | [リンク] |
| **コード** | [リンク(あれば)] |

## TL;DR

- [ポイント1]
- [ポイント2]
- [ポイント3]

---

## この論文は何を解決するのか?

[読者が共感できる問題設定から始める]

[元レポートの「背景・動機」セクションの内容をすべて含める]

### 従来のアプローチと限界

[元レポートの「既存手法の課題」をすべて含める]

[関連する図表があれば挿入]

---

## 提案手法の全体像

[元レポートの「提案手法」セクションの内容をすべて含める]

### アーキテクチャ

[図表を挿入]
![Figure X: アーキテクチャ](./figures/...)

[元レポートのアーキテクチャ説明をすべて含める]

### 技術的詳細

[元レポートの技術詳細をすべて含める]

#### [コンポーネント1]

[詳細説明]

#### [コンポーネント2]

[詳細説明]

### 重要な数式

[元レポートの数式をすべて含める]

$$[数式]$$

[数式の解説]

### アルゴリズム

[擬似コードがあれば含める]

---

## 実験と結果

### 実験設定

[元レポートの実験設定をすべて含める]

#### データセット

| データセット | サイズ | 特徴 |
|-------------|-------|------|
| [データセット1] | [サイズ] | [特徴] |

#### 評価指標

[元レポートの評価指標をすべて含める]

#### ベースライン

[元レポートのベースライン情報をすべて含める]

### 主要な結果

[結果テーブルを完全に転記]

[図表を挿入]
![Table X: 結果](./figures/...)

[結果の解説]

### アブレーション研究

[元レポートのアブレーション研究をすべて含める]

---

## 実用上のポイント

### こんな場面で使える

[ユースケースの説明]

### 注意点・制限

[元レポートの「限界」セクションの内容]

---

## 今後の展望

[元レポートの「今後の研究方向」をすべて含める]

---

## 参照論文の詳細

[元レポートの参照論文セクションをすべて含める]

### [論文1のタイトル]

| 項目 | 内容 |
|------|------|
| **著者** | [著者名] |
| **年** | [年] |
| **URL** | [リンク] |

[概要]

[主要な貢献]

[本論文との関係]

### [論文2のタイトル]

[同様に詳細を記載]

---

## まとめ

[元レポートの結論と所感を統合]

---

## 参考リンク

- [論文 (arXiv)](https://arxiv.org/abs/{arxiv_id})
- [コード (GitHub)](url)
- [関連論文1](url)
- [関連論文2](url)

---

*この記事は arXiv 論文 [{arxiv_id}](https://arxiv.org/abs/{arxiv_id}) を基に作成しました。*
*生成日: YYYY-MM-DD*

テックブログのテンプレート(サーベイ論文用)

markdown
# [分野名] 完全ガイド:[サブタイトル]

> [サーベイタイトル] を詳しく解説します

| 項目 | 内容 |
|------|------|
| **論文** | [タイトル] |
| **著者** | [著者名] |
| **arXiv** | [リンク] |

## この記事で分かること

- [ポイント1]
- [ポイント2]
- [ポイント3]

---

## [分野名] とは?

[元レポートの「サーベイの概要」をすべて含める]

[図表があれば挿入]

---

## 手法の分類(Taxonomy)

[元レポートの「分類体系」をすべて含める]

[Taxonomy の図表を挿入]

[分類体系のツリー構造をそのまま転記]

code

---

## 各カテゴリの詳細

[元レポートの各カテゴリ詳細をすべて含める]

### カテゴリ1: [名前]

[元レポートの内容をすべて含める]

[図表があれば挿入]

#### 代表的な手法

##### [手法名1]

[詳細説明]

##### [手法名2]

[詳細説明]

### カテゴリ2: [名前]

[同様に詳細を記載]

---

## 手法の比較

[元レポートの比較表をすべて転記]

| 手法 | 特徴1 | 特徴2 | 特徴3 |
|------|-------|-------|-------|
| [手法1] | [値] | [値] | [値] |

[図表があれば挿入]

---

## どの手法を選ぶべき?

[ユースケース別の推奨]

| ユースケース | 推奨手法 | 理由 |
|-------------|---------|------|
| [ケース1] | [手法] | [理由] |

---

## ベンチマークと評価

[元レポートのベンチマーク情報をすべて含める]

---

## 課題と今後の展望

[元レポートの「課題と今後の展望」をすべて含める]

---

## 重要な参照論文

[元レポートの参照論文セクションをすべて含める]

### [論文1のタイトル]

| 項目 | 内容 |
|------|------|
| **著者** | [著者名] |
| **年** | [年] |
| **URL** | [リンク] |

[概要]

[主要な貢献]

[手法の概要]

[本論文での引用箇所]

### [論文2のタイトル]

[同様に詳細を記載]

---

## まとめ

[元レポートの所感・コメントを統合]

---

## 参考リンク

- [論文 (arXiv)](https://arxiv.org/abs/{arxiv_id})
- [関連論文1](url)
- [関連論文2](url)

---

*この記事は arXiv 論文 [{arxiv_id}](https://arxiv.org/abs/{arxiv_id}) を基に作成しました。*
*生成日: YYYY-MM-DD*

文体変換ガイドライン

見出しの変換

元のセクションブログ形式
1. 概要(Abstract)TL;DR + 導入
2. 研究の背景と動機この論文は何を解決するのか?
3. 提案手法提案手法の全体像
4. 実験実験と結果
5. 結果と考察(実験と結果に統合)
6. 重要な参照論文参照論文の詳細
7. 結論と今後の展望今後の展望 + まとめ
8. 所感・コメント(まとめに統合)

文体の変換例(ですます調・丁寧語)

重要: ブログ記事はすべて「ですます調」「丁寧語」で統一してください。

学術的(である調)ブログ形式(ですます調)
「〜である」「〜です」
「〜だ」「〜です」
「〜する」「〜します」
「〜できる」「〜できます」
「〜ない」「〜ありません」「〜ません」
「〜であると考えられる」「〜と言えそうです」「〜と考えられます」
「本論文では」「この研究では」
「〜を提案する」「〜を提案しています」
「〜が示された」「〜が示されました」
「〜を検証した」「〜を検証しました」
「結果として〜となった」「結果として〜となりました」
「Figure 1 に示すように」「下の図をご覧ください」
「Table 1 は〜を示す」「この表から〜がわかります」
「注意が必要である」「注意が必要です」「ご注意ください」
「〜を参照されたい」「〜をご参照ください」

チェックリスト

変換完了前に確認:

文体の確認(最重要)

  • すべての文が「ですます調」で統一されている
  • 丁寧語が適切に使用されている
  • 「である」「だ」などの常体が残っていない
  • 読者への敬意が感じられる文体になっている

図表の確認

  • 元レポートのすべての ![...](...) が含まれている
  • 図表のキャプションが維持されている
  • 図表の解説が含まれている

技術詳細の確認

  • すべての数式が含まれている
  • アルゴリズム・擬似コードが含まれている
  • 各コンポーネントの詳細説明が含まれている

実験情報の確認

  • データセット詳細が含まれている
  • 評価指標が含まれている
  • ベースライン手法が含まれている
  • 結果テーブルが完全に転記されている
  • アブレーション研究が含まれている

参照論文の確認

  • すべての参照論文の詳細が含まれている
  • 各論文の URL リンクが含まれている

リンクの確認

  • arXiv リンクが含まれている
  • GitHub リンクが含まれている(あれば)
  • すべての外部リンクが維持されている

出力先

code
reports/{arxiv_id}_blog.md

コマンド例

code
# 基本的な使用方法
/blog-format 2401.12345

# 最新のレポートを変換
/blog-format

# ターゲット読者を指定(文体の調整に使用、内容は削減しない)
/blog-format 2401.12345 --audience "ML初心者"

オプション

オプション説明デフォルト
--audienceターゲット読者層(文体調整用)"MLエンジニア"

--audience の選択肢

文体の調整
"ML初心者"専門用語に補足説明を追加
"MLエンジニア"標準的な技術ブログ文体
"研究者"より学術的なトーンを維持

注意: --audience は文体を調整するだけで、内容を削減しません。


変換時の注意事項

絶対に削除しないもの

  • 図表とそのパス
  • 数式
  • 実験結果の数値
  • 参照論文の詳細
  • URLリンク
  • 比較表
  • アルゴリズム

精度の維持

  • 技術的な主張を歪めない
  • 数値は正確に引用
  • 「〜かもしれない」「〜と思われる」の違いを維持
  • 原著者の主張と自分の解釈を区別

文体の一貫性

  • すべての文を「ですます調」で統一する
  • 「である」「だ」などの常体を混在させない
  • 見出しや箇条書きの説明文も丁寧語で書く
  • 引用文は原文のまま、解説部分は丁寧語で書く

修正履歴への追記

ブログ形式変換後、元のレポートの修正履歴を更新:

markdown
## 修正履歴

| 日付 | 修正タイプ | 内容 |
|------|-----------|------|
| YYYY-MM-DD | ブログ変換 | テックブログ形式に変換 (reports/{arxiv_id}_blog.md) |

関連スキル

  • /analyze-paper: 元となるレポートを生成
  • /fix-report: ブログ変換前のレポート修正
  • /add-figures: 図表の追加(ブログでも活用可能)