# Blog Agent - Claude Code プロジェクト設定

このリポジトリは、Claude Code を使って効率的に日本語ブログを執筆するためのスキル集です。

## クイックスタート

### 1. 過去記事から文体を抽出

```
過去記事の文体を抽出して
corpus/ ディレクトリの記事からStyle Cardを作って
```

### 2. アウトライン候補を生成

```
「リモートワークの生産性向上」というテーマで、
エンジニア向けに3〜5案のアウトラインを出して
```

### 3. 番号で選択して確定

```
2番をベースに、もう少し実践的な内容にして
```

### 4. 本文を執筆

```
このアウトラインで2,000字くらいの記事を書いて
```

### 5. 編集・仕上げ

```
仕上げて。冗長な部分は削って
```

### 6. SNS転用

```
X用に短くして。スレッドも作って
```

## 出力ファイル

すべての成果物は `out/` ディレクトリに保存されます：

| ファイル | 内容 |
|----------|------|
| `out/style_card.md` | 文体・構成パターン |
| `out/research_brief.md` | リサーチ結果 |
| `out/outline_options.md` | アウトライン候補（3〜5案） |
| `out/final_outline.md` | 確定アウトライン |
| `out/draft.md` | 初稿 |
| `out/final.md` | 最終稿 |
| `out/sns_posts.md` | SNS投稿案 |
| `out/edit_log.md` | 編集ログ（任意） |
| `out/tuning_notes.md` | フィードバック記録 |

## スキル一覧

| スキル名 | 責務 | トリガー例 |
|----------|------|------------|
| `jp-blog-style-profiler` | 文体抽出 | 「過去記事の文体を抽出して」 |
| `jp-web-research-brief` | リサーチ | 「根拠をつけて」「最新動向を踏まえて」 |
| `jp-claim-outline-generator` | アウトライン候補生成 | 「3〜5案出して」「構成案を」 |
| `jp-interactive-outline-selector` | 選択・確定 | 「2番で」「この中から選ぶ」 |
| `jp-blog-drafter-4000` | 本文執筆 | 「本文を書いて」「2,000字で」 |
| `jp-blog-editor-qc` | 編集・QC | 「仕上げて」「冗長を削って」 |
| `jp-sns-repurposer` | SNS転用 | 「X用に」「スレッドにして」 |
| `jp-style-incremental-updater` | 文体の段階的更新 | 「文体を更新して」「この記事をStyle Cardに反映」 |
| `jp-feedback-tuner` | フィードバック反映 | 「今後は短く書いて」「この指示を覚えて」 |

## 典型ワークフロー

```mermaid
graph TD
    A[テーマを決める] --> B[文体抽出]
    B --> C[リサーチ]
    C --> D[アウトライン候補生成]
    D --> E[番号選択・確定]
    E --> F[本文執筆]
    F --> G[編集・QC]
    G --> H[SNS転用]
```

## ディレクトリ構成

```
blog_agent/
├── CLAUDE.md           # このファイル
├── README.md           # プロジェクト説明
├── docs/               # 設計ドキュメント
├── corpus/             # 過去記事（文体抽出用）
├── out/                # 生成物（gitignore推奨）
└── .claude/
    └── skills/         # Claude Code スキル
        ├── jp-blog-style-profiler/
        ├── jp-web-research-brief/
        ├── jp-claim-outline-generator/
        ├── jp-interactive-outline-selector/
        ├── jp-blog-drafter-4000/
        ├── jp-blog-editor-qc/
        ├── jp-sns-repurposer/
        ├── jp-style-incremental-updater/
        └── jp-feedback-tuner/
```

## 注意事項

- `out/` ディレクトリは `.gitignore` に追加することを推奨
- 機密情報（社内情報、個人情報）を corpus/ に入れる場合は注意
- リサーチには Web 検索を使用するため、APIキーの設定が必要な場合あり

## カスタマイズ

各スキルの動作を変更したい場合は、`.claude/skills/[スキル名]/SKILL.md` を編集してください。

主な調整ポイント：
- 文字数の目安（デフォルト: 2,000字）
- アウトライン候補数（デフォルト: 3〜5案）
- 出力フォーマット
- チェック項目