Claude Codeで過去記事を分析して記事生成を自動化

skill-name/
├── SKILL.md       - 必須
├── scripts/       - 実行可能コード（Python/Bash等）
├── references/    - 必要に応じてコンテキストに読み込むドキュメント
└── assets/        - 出力に使用するファイル（テンプレート等）

---
name: skill-name
description: This skill should be used when...
---

# Skill Name

Instructions for Claude...

---
name: agent-name
description: エージェントの説明と使用例
model: sonnet
---

You are the **Agent Name**, an expert in...

## Core Identity

エージェントの役割を定義...

## Workflow

1. Step 1
2. Step 2
3. Step 3

## Available Skills

使用するスキルを列挙...

.claude/
├── agents/
│   ├── article-analyzer.md         # 記事分析Subagent
│   └── article-writer.md           # 記事執筆Subagent
└── skills/
    ├── analysis_framework/         # 記事分析フレームワーク
    │   ├── skill.md                # 分析手法の定義（6要素抽出）
    │   └── examples.md             # 分析結果のサンプル出力（JSON形式）
    ├── article_templates/          # 記事テンプレート集
    │   ├── skill.md                # テンプレート選択ロジック
    │   └── templates/
    │       ├── qiita/
    │       │   ├── erc_eip.md      # ERC/EIP標準テンプレート
    │       │   ├── handson.md      # ハンズオンテンプレート
    │       │   ├── tech_tips.md    # 技術解説テンプレート
    │       │   └── tool_intro.md   # ツール紹介テンプレート
    │       ├── zenn-article/
    │       │   ├── common.md       # Zenn記事共通テンプレート
    │       │   ├── erc_eip.md      # ERC/EIP標準テンプレート
    │       │   ├── contract_analysis.md
    │       │   ├── tech_concept.md
    │       │   ├── tool_service.md
    │       │   └── personal_dev.md
    │       └── zenn-book/
    │           ├── common.md       # Zenn Book共通テンプレート
    │           ├── protocol_service.md
    │           ├── erc_eip.md
    │           ├── defi.md
    │           ├── contract.md
    │           └── solidity.md
    └── tone_guidelines/            # 文体・スタイルガイドライン
        ├── skill.md                # 文体ルールの定義
        ├── intro_outro.md          # はじめに・最後にテンプレート（カスタム）
        └── wordings.md             # 言い回し集（具体的な表現例）

article-analyzer agentを使用して、qiita/articles/、zenn/articles/、zenn/books/ の記事を分析し、examples.md とカテゴリ別テンプレートを作成してください。

入力例: 「EASについて記事を書きたいです。ドキュメントはこちらです。https://docs.attest.org/」

入力例: 「React Server Componentsについて記事を書きたいです。参考記事が2つあります。https://ja.react.dev/reference/rsc/server-components, https://ja.react.dev/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#react-server-components」

入力例: 「UniswapV4のコントラクトについて記事を書きたいです。https://github.com/Uniswap/v4-core」

{
  "article_id": "erc20-comprehensive-guide",
  "title": "ERC20を1からわかりやすく解説",
  "theme": "ERC20トークン規格の基礎から実装まで",
  "main_claim": "ERC20は統一されたトークン規格であり...",
  "target_audience": "beginner",
  "problems": [
    {
      "description": "トークン規格が標準化される前は...",
      "context": "DEXやウォレットとの連携が困難で...",
      "impact": "エコシステムの断片化、開発コストの増大"
    }
  ],
  "solutions": [...],
  "code_highlights": [...],
  "prerequisites": ["Solidityの基本構文", "Ethereumのアカウントモデル"],
  "limitations": ["スマートコントラクトへの誤送金時に回収不可能"],
  "structure_notes": {
    "sections": ["はじめに", "ERC20とは", "インターフェース解説", ...],
    "storytelling_techniques": ["問題提起から始める", "図解を使った視覚的説明"]
  }
}

# ERC/EIP標準記事テンプレート（Qiita）

577本の分析結果に基づくERC/EIP解説記事のテンプレート。

## メタデータ

(YAMLフロントマターの形式)

## 記事構成

### 1. はじめに（固定）
(固定テンプレート)

### 2. 概要
(このセクションの目的と典型的な内容)

### 3. 動機
...

## 記述ルール

### Qiita固有ルール
- Solidityコードは `js` で記述
- `:::note` ブロック内にリンクを含めない
...

## チェックリスト
- [ ] メタデータが正しい形式
- [ ] はじめに・最後にが固定テンプレート通り
...

## 導入部の表現

### 記事の目的を述べる

**推奨パターン**
今回は『**〇〇**』についてまとめていきます。
「**〇〇がわからない、なんとなく理解している方**」
こんな人の役に立てば幸いです。

## 説明の表現

### 定義を述べる

**推奨パターン**
〇〇とは、△△するための仕組みです。
〇〇は、△△を目的として設計されています。

## 避けるべき表現一覧

| 避けるべき表現 | 推奨表現 |
|--------------|---------|
| 〜である | 〜です |
| **パラメータ**: | パラメータとして、〜 |
| **注意**: | 注意点として、〜 |

.claude/
├── agents/
│   └── article-writer.md       # Subagent本体
└── skills/
    ├── analysis_framework/
    │   └── skill.md            # 分析手法の定義
    ├── article_templates/
    │   └── skill.md            # テンプレート選択ロジック
    └── tone_guidelines/
        └── skill.md            # 文体ルールの定義

article/
├── [プラットフォーム1]/
│   └── articles/       # 記事のMarkdownファイル
└── [プラットフォーム2]/
    └── articles/       # 記事のMarkdownファイル

article/
├── qiita/
│   └── articles/
└── zenn/
    ├── articles/
    └── books/

claude

article-analyzer agentを使用して、[記事ディレクトリ] の記事を分析し、examples.md とカテゴリ別テンプレートを作成してください。

article-analyzer agentを使用して、qiita/articles/、zenn/articles/、zenn/books/ の記事を分析し、examples.md とカテゴリ別テンプレートを作成してください。

.claude/skills/
├── analysis_framework/
│   └── examples.md             # 分析サンプル（JSON形式）
└── article_templates/
    └── templates/
        └── [プラットフォーム名]/
            ├── [カテゴリ名].md  # カテゴリ別テンプレート
            └── ...

{
  "articles": [
    {
      "article_id": "erc20-comprehensive-guide",
      "title": "ERC20を1からわかりやすく解説",
      "platform": "zenn-article",
      "theme": "ERC20トークン規格の基礎から実装まで",
      "main_claim": "ERC20は統一されたトークン規格であり...",
      "target_audience": "beginner",
      "problems": [...],
      "solutions": [...],
      "code_highlights": [...],
      "prerequisites": ["Solidityの基本構文"],
      "limitations": ["スマートコントラクトへの誤送金時に回収不可能"],
      "structure_notes": {
        "sections": ["はじめに", "ERC20とは", "インターフェース解説"],
        "storytelling_techniques": ["問題提起から始める"]
      }
    }
  ],
  "analysis_metadata": {
    "date": "2024-01-15",
    "total_articles": 10,
    "platforms": { "qiita": 5, "zenn-article": 3, "zenn-book": 2 }
  }
}

# ERC/EIP標準記事テンプレート（Qiita）

577本の分析結果に基づくERC/EIP解説記事のテンプレート。

## メタデータ

(YAMLフロントマターの形式を記載)

## 記事構成

### 1. はじめに（固定）
(固定テンプレートを記載)

### 2. 概要
(このセクションの目的と典型的な内容を記載)

## 記述ルール

### Qiita固有ルール
- Solidityコードは `js` で記述
- `:::note` ブロック内にリンクを含めない

## チェックリスト
- [ ] メタデータが正しい形式
- [ ] はじめに・最後にが固定テンプレート通り

[記事ディレクトリ] から各カテゴリの代表的な記事を5〜10件選び、頻出する言い回しパターンを抽出してください。「導入部の表現」「説明の表現」「注意点の表現」「避けるべき表現」に分類し、.claude/skills/tone_guidelines/wordings.md に出力してください。

qiita/articles/、zenn/articles/、zenn/books/ から各カテゴリの代表的な記事を5〜10件選び、頻出する言い回しパターンを抽出してください。「導入部の表現」「説明の表現」「注意点の表現」「避けるべき表現」に分類し、.claude/skills/tone_guidelines/wordings.md に出力してください。

# 言い回し集

## 1. 導入部の表現

### 記事の目的を述べる

**推奨パターン**
今回は『**〇〇**』についてまとめていきます。

## 2. 説明の表現

### 定義を述べる

**推奨パターン**
〇〇とは、△△するための仕組みです。

## 11. 避けるべき表現一覧

| 避けるべき表現 | 推奨表現 |
|--------------|---------|
| 〜である | 〜です |
| **パラメータ**: | パラメータとして、〜 |

# Intro/Outro Templates (CUSTOM - Replace with your own)

このファイルには固定の「はじめに」と「最後に」のテンプレートを定義しています。
プレースホルダーを自分の情報に置き換えてください。

## プレースホルダー

- `{platform_1}`, `{platform_2}`: 使用するプラットフォーム名
- `{your_sns_links}`: あなたのSNSリンクや自己紹介

---

## 1. {platform_1}用

### はじめに

```markdown
## はじめに

{your_sns_links}

今回は「**〇〇**」についてまとめていきます。
```

### 最後に

```markdown
## 最後に

今回は「**〇〇**」についてまとめてきました。

{your_sns_links}
```

---

## 2. {platform_2}用

### はじめに

```markdown
## はじめに

{your_sns_links}

今回は「**〇〇**」についてまとめていきます。
```

### 最後に

```markdown
## 最後に

今回は「**〇〇**」についてまとめてきました。

{your_sns_links}
```

---

## 使い方

1. `{platform_1}`, `{platform_2}` を使用するプラットフォーム名に置き換える
2. `{your_sns_links}` を自分のSNSリンクや自己紹介に置き換える
3. 「**〇〇**」の部分は記事作成時にテーマに置き換えられる
4. プラットフォームごとにリンク先が異なる場合は、それぞれ設定する

article-writer agentを使用して、〇〇について簡単な記事を書いてください。

.claude/
├── agents/
│   ├── article-analyzer.md         # テンプレート
│   └── article-writer.md           # テンプレート
└── skills/
    ├── analysis_framework/
    │   ├── skill.md                # テンプレート
    │   └── examples.md             # Step 4で作成
    ├── article_templates/
    │   ├── skill.md                # テンプレート
    │   └── templates/              # Step 4で作成
    │       ├── qiita/
    │       ├── zenn-article/
    │       └── zenn-book/
    └── tone_guidelines/
        ├── skill.md                # テンプレート
        ├── intro_outro.md          # Step 6でカスタマイズ
        └── wordings.md             # Step 5で作成

article-writer agentを使用して、EASについてZenn記事を書いてください。ドキュメントはこちらです。https://docs.attest.org/

article-writer agentを使用して、React Server ComponentsについてQiita記事を書いてください。参考記事: https://example.com/article1 https://example.com/article2

article-writer agentを使用して、OpenZeppelinのERC20実装について解説記事を書いてください。https://github.com/OpenZeppelin/openzeppelin-contracts