Blog workflow

ブログ品質チェックワークフロー

When to Use

• ブログ記事の執筆・編集が完了したとき
• 「記事をチェックして」「品質チェックして」と依頼されたとき
• ブログ用のMarkdownファイルを仕上げるとき
• 投稿先プラットフォーム（はてなブログ / note）を指定されたとき

Instructions

概要

このスキルは、ブログ記事に対する複数の品質チェックを1つのワークフローとしてまとめたものです。 個別にコマンドを打つ代わりに、このスキルが発動すれば一連のチェックが順番に実行されます。 また、ユーザーが「差し替えして」「差し替えをするように」と指示した場合は、提案文を示すだけでなく、対象部分を実際に差し替える（ApplyPatchを使ってMarkdownファイルを書き換える）ことを基本とします。

ワークフロー全体の流れ

記事の編集完了
  ↓
Step 1: textlintチェック（自動修正 → 残りエラー修正）
  ↓
Step 2: フォーマット確認（プラットフォーム別に分岐）
  ├── はてなブログ → hatena-formatter サブエージェント
  └── note        → note-formatter サブエージェント
  ↓
Step 3: 読者目線レビュー（伝わりやすさの確認）
  ↓
結果サマリーを報告

Step 1: textlintチェック

1-1. 自動修正の実行

npx textlint --fix "対象ファイルパス"

1-2. 残りエラーの確認

npx textlint "対象ファイルパス"

1-3. 手動修正が必要なエラーへの対応

自動修正できなかったエラーについて、以下の情報を整理する。

• 行番号
• エラー内容
• ルール名
• 修正案

修正案を適用し、再度 npx textlint を実行してエラーが0件になるまで繰り返す。

Step 2: フォーマット確認（プラットフォーム別）

投稿先のプラットフォームに応じて、対応するフォーマッターのサブエージェントを呼び出す。

プラットフォームの判定

• ユーザーが「はてなブログ」「note」と明示した場合はそれに従う
• 明示がない場合はユーザーに確認する
• ファイル名に blog_ プレフィックスがある場合ははてなブログをデフォルトとする

はてなブログの場合

hatena-formatter サブエージェントを呼び出す。主なチェック項目は以下のとおり。

• 見出しがh3（###）から始まっているか
• h1（#）、h2（##）が使われていないか
• 見出しの階層が守られているか（h3 → h4 → h5の順）
• [:contents] が記事冒頭（フロントマター直後）にあるか
• コードブロックに言語指定があるか
• 段落ごとに空行が入っているか

noteの場合

note-formatter サブエージェントを呼び出す。主なチェック項目は以下のとおり。

• 見出しがh2（##）とh3（###）のみで構成されているか
• 最初の見出しがh2（##）になっているか（h3から始まっていないか）
• h1、h4以降が使われていないか（h1→h2、h4以降→h3に変換）
• テーブル記法が使われていないか（noteでは非対応）
• はてなブログ固有記法（[:contents]、フォトライフ記法）が含まれていないか
• 段落ごとに空行が入っているか

問題があれば修正する。内容（文章そのもの）は変更しない。

Step 3: 読者目線レビュー

以下の観点で記事を確認する。

前提知識の確認

• 専門用語が初出で説明なく使われていないか
• 略語やツール名の正式名称が示されているか

文脈のつながり

• セクション間の論理的なつながりがあるか
• 話題が唐突に変わっていないか

具体性

• 抽象的な説明だけで終わっていないか
• 具体例やコード例が適切に添えられているか

行動につながるか

• 読者が記事を読んだ後に何をすべきか明確か
• 参考リンクやリソースが提示されているか

結果サマリー

全ステップ完了後、以下の形式で結果を報告する。

## 品質チェック結果

### textlint
- 初回エラー数: X件
- 自動修正: X件
- 手動修正: X件
- 最終エラー数: 0件

### フォーマット（プラットフォーム: はてなブログ / note）
- 修正箇所: X件（または「問題なし」）

### 読者目線レビュー
- 指摘事項: X件（または「問題なし」）
- 主な指摘: ...

注意事項

• textlintのエラーが0件になるまでStep 1を繰り返す
• フォーマット修正では記事の内容を変えない
• 読者目線レビューは指摘のみ。修正するかは人間が判断する
• 各ステップの結果を報告してから次に進む