Agent Skills: ブログ推敲・生成ワークフロー

ブログ・記事・note の本文を「アテンションライティング(次の1行を読みたくなるか)」と「日本語作文技術(修飾語順・読点・入れ子)」の 2 軸で執筆・推敲する。Use when 草稿の推敲、読まれる文章への書き直し、修飾語順や読点の指摘、AI っぽさの除去、離脱されない文章への改善を依頼されたとき、あるいは新規本文の生成を依頼されたとき。Don't use for 短文 SNS・ビジネスメール、構成案レビューや見出し設計のみの依頼(blog-prewriting を使う)、構成案からの本文新規執筆で文体寄せが主目的の依頼(blog-drafting を使う)。

UncategorizedID: suntory-n-water/sui-blog/blog-revision

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Suntory-N-Water/sui-blog/tree/HEAD/.agents/skills/blog-revision

Skill Files

Browse the full folder contents for blog-revision.

Download Skill

Loading file tree…

.agents/skills/blog-revision/SKILL.md

Skill Metadata

Name
blog-revision
Description
ブログ・記事・note の本文を「アテンションライティング(次の1行を読みたくなるか)」と「日本語作文技術(修飾語順・読点・入れ子)」の 2 軸で執筆・推敲する。Use when 草稿の推敲、読まれる文章への書き直し、修飾語順や読点の指摘、AI っぽさの除去、離脱されない文章への改善を依頼されたとき、あるいは新規本文の生成を依頼されたとき。Don't use for 短文 SNS・ビジネスメール、構成案レビューや見出し設計のみの依頼(blog-prewriting を使う)、構成案からの本文新規執筆で文体寄せが主目的の依頼(blog-drafting を使う)。

ブログ推敲・生成ワークフロー

ブログ本文を、最後まで読まれる文章に仕上げる。判断軸は 2 つ。

  • アテンションライティング軸: 「この行を読んだ人は、次の行を読みたくなるか」
  • 作文技術軸: 修飾語順、読点、入れ子解消などの再現可能な日本語ルール

Step 1: モードと論調を判定する

  1. 依頼内容から モード を判定する。
    • 推敲モード: 既存の文章(貼り付け、ファイルパス、contents/blog/*.md など)があり「直して」「書き直して」と頼まれた。
    • 生成モード: まだ本文が存在せず「〜について記事を書いて」と頼まれた。
    • 曖昧なときは一度だけユーザーに確認する。
  2. 対象文章から 論調 を判定する。判定基準は以下。
    • 硬めの論調: 新仕様の解説記事、既存技術の活用記事。背景説明や課題提起が必要。
    • ふわっとした論調: Tips、調査記事、エラー解決のような短い実践報告。
  3. 依頼に 軸の明示指定 があるか確認する。
    • 「アテンションライティングだけで見て」「修飾語順だけチェック」のような指定があれば、その軸の reference だけ読む。
    • 指定がなければ 2 軸とも適用する。

Step 2: 推敲モードのパイプライン

軸を指定順に走らせる。並列ではなくパイプライン。前段の結果を後段が壊さないこと。

  1. アテンションライティング軸 を適用する。
    • references/attention-writing.md を読む。
    • そのファイルの「推敲モードの進め方」に従い、冒頭診断・1 文長・離脱ポイント・装飾削除を抽出する。
  2. 作文技術軸 を適用する。
    • references/japanese-composition.md を読む。
    • そのファイルの修飾語順、読点、入れ子、表記の各ルールに照らして指摘を抽出する。
  3. 論調が硬めのとき は、書き直しの冒頭設計で「コンテキストファースト + 共感と裏切り」の型を意識する。型の詳細は ../../blog-prewriting/references/composition-strategy.md を読む(SCQ + Deep Empathy、共感と裏切り、アンチパターン)。AW の「冒頭 3 行で掴め」を満たす範囲で背景説明と読者の現状肯定を配置する。
  4. 論調がふわっとのとき は、冒頭設計の型は使わず、AW の「いちばん美味しいものを最初に出す」をそのまま適用する。
  5. 依頼が貼り付け本文や音声入力ベースのとき(「自分の地の文を整えて」「録音の文字起こしを直して」など)は、上記 1〜2 を適用する前に references/voice-preservation.md を読み、最小編集原則を作用させる。AW / 作文技術軸の指摘は、地の文の温かみを壊さない範囲に限定する。

Step 3: 生成モードの進め方

  1. 題材・要点・読者像をユーザーに確認する(既出なら省略)。
  2. references/attention-writing.md の「生成モードの進め方」に従い、大まかな方向だけ決めて冒頭から書く。
  3. 書き終わったら推敲モードのパイプライン(Step 2)を 1 周自分でかける。

Step 4: 出力する

  1. assets/revision-report-template.md の構造に従ってレポートを組み立てる。
  2. ユーザーが「全文だけ」「差分だけ」のように出力範囲を指示した場合はそれに従う。
  3. 強調表現の ** は出力しない。

軸間の矛盾解消ルール

2 軸が衝突したときは、以下を優先する。自動判断せず、必ず以下に従う

  • 冒頭の作り方: アテンションライティング軸を優先する。「結論や面白いポイントを早く出せ」を最上位とし、共感や前置きはこの基準を満たす範囲でのみ残す。
  • 主語の扱い: 作文技術軸を優先する。ただし機械的な「私」削除は行わず、「同一段落内で『私』が 3 回以上連続したときに限り削除」する。

やってはいけないこと

  • 煽り化・釣りタイトル化(中身のない「衝撃!」「ヤバすぎ!」)
  • 論旨の改変(主張・結論・固有名詞・数値を勝手に変えない)
  • 章立てを先に完成させてから埋める(生成モードでは冒頭から書く)
  • 2 軸を並列同時実行する(Step 2 のパイプライン順を守る)
  • references を毎回全部読みに行く(軸の明示指定や論調判定で不要な reference は読まない)

Error Handling

  • 依頼が構成案レビュー(本文がない、見出しだけの相談)なら、blog-prewriting に切り替える。
  • 依頼が構成案からの本文新規執筆で、文体寄せが主目的なら、blog-drafting に切り替える。
  • 短文 SNS・ビジネスメールへの適用依頼は断る(別の作法が必要)。
  • 「構成のコンテキストファースト/共感と裏切りの詳細手順を知りたい」と聞かれたら、../../blog-prewriting/references/composition-strategy.md を案内する(構成設計そのものは blog-prewriting の責務)。
ブログ推敲・生成ワークフロー Skill | Agent Skills