# jp-blog-agent-skills

日本語ブログを「あなたの文体」に寄せつつ、リサーチ → 主張（論点）提案 → セクション案提示 → 応答式で選択 → 約2,000字で本文執筆 → 仕上げ（品質チェック） → SNS転用までを、**Agent Skills**（スキル）として分割・運用するためのリポジトリ雛形です。

このリポジトリは「文章生成そのもの」ではなく、**ブログ執筆エージェントを作るための“再利用可能な技能（Skills）”の設計書**として使います。

---

## 背景（Agent Skills とは）

Agent Skills は、`SKILL.md`（YAMLフロントマター＋手順）と任意の補助ファイル（テンプレート、スクリプト、参考資料）からなるフォルダを、エージェントが必要時に読み込む仕組みです。  
スキルは **モデルが自律的に必要だと判断したときに発火**します（ユーザーが明示的に呼ぶ“コマンド”とは別）。  
詳細は公式ドキュメントを参照してください。

---

## インストール

### npx でインストール（推奨）

任意のプロジェクトで以下を実行するだけで、スキルと設定ファイルがインストールされます：

```bash
npx @timakin/blog-agent-skills
```

これにより以下がインストールされます：
- `CLAUDE.md` - Claude Code向けの設定ファイル（プロジェクトルート）
- `.claude/skills/` - 7つのブログ執筆スキル

**オプション：**
```bash
npx @timakin/blog-agent-skills --force  # 既存ファイルを上書き
npx @timakin/blog-agent-skills --help   # ヘルプを表示
```

---

## 使い方（Claude Code / Agent SDK / VS Code Copilot）

### 1) Claude Code（npxでインストール後）
1. プロジェクトルートで `npx @timakin/blog-agent-skills` を実行
2. Claude Code を起動し、通常通り依頼してください（例: 「過去記事から文体を抽出して、3つの論点案を出して」）

> `SKILL.md` の `name` / `description` が discovery（発火判定）に使われます。
> それぞれのスキルの `description` を、あなたの実運用で出てくる言い回しに寄せるほど安定します。

### 2) 手動インストール（リポジトリをコピー）
1. このリポジトリをあなたのブログ執筆プロジェクトにコピー（またはサブツリー化）します
2. `.claude/skills/` が **リポジトリ直下**に存在する状態にします
3. Claude Code をプロジェクトルートで起動してください

### 3) Claude Agent SDK（Python / TypeScript）
SDK からスキルを使う場合は、**(a) Skill ツールを許可**し、**(b) filesystem 設定を読み込み**ます。  
（例: `allowed_tools` に `"Skill"`、`setting_sources` に `"user"` / `"project"` を含める）

※ `allowed-tools:`（SKILL.md の frontmatter の権限制御）は Claude Code CLI 向けのため、SDK 側では SDK の `allowed_tools` 設定で制御してください。

### 4) VS Code Copilot（任意）
VS Code では `.github/skills/` が推奨配置です（`.claude/skills/` も互換で読める場合があります）。  
Copilot 側で使う場合は `.github/skills/` へ複製してください。

---

## 含まれるスキル（概要）

- `jp-blog-style-profiler`  
  過去記事から文体・構成・語彙・レトリックを抽出して「Style Card」を生成
- `jp-web-research-brief`  
  記事テーマに対するリサーチ、要点と根拠（URL/日付/媒体）を整理
- `jp-claim-outline-generator`  
  主張（論点）方向性と見出し（H2/H3）案を複数提示
- `jp-interactive-outline-selector`  
  候補選択を“応答式”で進め、最終アウトラインを確定
- `jp-blog-drafter-4000`  
  約2,000字で本文を執筆（見出し・導入・具体例・結論・CTA）
- `jp-blog-editor-qc`  
  字数・論理・表現・重複・断定の強さ等をチェックし、最終稿に整える
- `jp-sns-repurposer`  
  X / LinkedIn 等のSNS投稿に転用する短文・スレッド案を生成

---

## 安全・運用上の注意

- スキルは“強力”です。外部から取得したスキルやスクリプトは必ずレビューしてください。  
- 機密情報（APIキー、顧客データ、未公開資料）を `SKILL.md` やテンプレートに直書きしないでください。  
- リサーチ結果を記事に入れる場合は、**出典（リンク・日付・媒体）**を残し、断定は避けます。

---

## 次にやること

- `docs/30_codegen-agent-instructions.md` を読み、あなたの開発環境（Python/TypeScript、CLI/Web）に合わせて“ブログ執筆エージェント本体”を実装してください。
- `docs/20_conversation-flow.md` をベースに、あなたの対話スタイルに合わせて質問順や出力フォーマットを調整してください。