newsletter-voice

ニュースレターの文体

Codex と Claude の実行環境

• Codex または Claude では、現在のタスクで実際に利用できるツールを使って、このスキルを使用してください。AskUserQuestion の例は質問内容を示すものであり、必須の API ではありません。利用可能な質問ツールがあればその制限内で使用し、なければチャットで質問してください。すでに提供されている回答や資料は再利用してください。
• ユーザーが選択したプロジェクトで作業してください。パーソナライズされた作業の前に、そのプロジェクトの about-me.md、voice.md、関連するブランドファイルを読んでください。ファイル間に矛盾がある場合や初期設定の内容が含まれる場合は、意図された執筆者を確認してください。不足している情報は質問するか、voice-builder を実行してください。メンテナーの身元、アカウント、非公開ファイルを引き継いではいけません。
• 同梱されている references/ は、このスキルのフォルダーを基準に参照してください。明示的にプロフィールの更新を依頼された場合は、既存のユーザー情報やルールを保持しながら、正規の about-me.md、voice.md、または newsletter-voice.md をその場で読み、更新してください。利用者はこれらの正規ファイルを読み直す必要があります。既存の無関係なファイルと名前が重複する新しい成果物を作成する場合に限り、新しいファイル名を使用してください。インストールだけでインタビューを開始したり、ファイルを書き込んだりしてはいけません。依頼がない限り、永続的な学習内容を書き込まないでください。
• まず提供された根拠を使用してください。必要に応じて、利用可能な検索ツールや情報源ツールで外部の主張を検証してください。情報源や連携機能が利用できない場合は、不足している機能を明示し、提供されたテキストやエクスポートデータの入力を提案してください。事実、一人称の体験、指標、ツールの実行成功を捏造してはいけません。
• 選択した手順に必要なサービスのみ、ユーザーの既存アカウントを通じて接続してください。認証情報を表示したり、接続を上書きしたりしてはいけません。下書きの作成、保存、レビューは、公開、メッセージ送信、アカウント変更の許可にはなりません。

前提条件の確認

このスキルが呼び出されたら、すぐにプロジェクトのルートに voice.md と about-me.md があるか確認してください。

どちらかのファイルがない場合は、ユーザーに次のように伝えてください。

ニュースレターの文体は、一般的な文体プロフィールを基礎とします。まず voice-builder を実行してください（スキルをアップロードするか、「build my voice」と入力してください）。その後、about-me.md と voice.md がプロジェクトにある状態で、ここに戻ってください。

その後、処理を停止してください。両方のファイルが存在するまで、先へ進んではいけません。

両方のファイルが存在する場合は、全文を読んでから、すぐにステップ 1 に進んでください。

ステップ 1. サンプルを確認する

チャットでユーザーに次のように質問してください。

過去のニュースレターを 2～3 件お持ちですか？参考にします。

はい：こちらに貼り付けてください（1 件ずつでも、まとめてでも構いません） いいえ：「archetype」と入力してください。あなたの文体に合わせたテンプレートを使って作成します

返答を待ってください。

ユーザーがニュースレターを 2 件以上貼り付けた場合は、ステップ 2a に進んでください。 ユーザーが「archetype」と入力した場合は、ステップ 2b に進んでください。 ユーザーがニュースレターを 1 件貼り付けた場合は、もう 1 件以上を依頼してください。1 件しかない場合は、次のように提案してください。「パターンを特定するには、サンプルが 1 件では足りません。アーキタイプモードに切り替えて、そのニュースレターを参考にしてもよいですか？」

ステップ 2a. サンプルに基づく分析

各ニュースレターを最後まで読みます。単発の特徴ではなく、複数の号に共通するパターンを探します。以下を抽出します。

冒頭の型

• 最初の3文が何をしているか（具体的な成果、文化的な観察、主張、情景、問いかけ）
• 最初の構成上の区切りまでの冒頭部分の長さ
• 信頼性を示す工夫（著者が序盤で権威性をどのように確立しているか）
• 価値の約束（読者が何を得られると伝えているか）

セクションの構成

• 問題や対比の提示
• 名前の付いたフレームワーク、または自由形式の文章
• 番号付きの手順や方法、または一貫した論旨
• 例と根拠のパターン
• ボーナスまたは発展セクション
• 締めくくりの型と署名

データに対する考え方

• 各号に含まれる具体的な数値（数を数える）
• 出典の示し方（リンク付き、名称のみ、出典の記載なし）
• 具体例と抽象的な説明の比率
• 制約や失敗への言及

書式

• 見出しの使用（頻度、階層）
• リストの使用（番号付き、箇条書き、矢印）
• 太字と斜体の使用
• プロンプト、コードブロック、引用ブロックの書式
• 視覚的な記号（矢印、チェックマーク、絵文字など）

長さ

• サンプル全体の単語数の範囲
• セクションごとの単語数

ニュースレター形式ならではの文体の特徴

• プロ向けのヒントや囲み記事（頻度、形式）
• 今後の展望を示す締めくくり
• サンプル全体で一貫している署名のフレーズ
• メタ的な透明性（著者が執筆プロセスを振り返ったり、フィードバックを求めたりしているか）

見られない特徴

• すべてのサンプルに見られない単語、表現、構成
• 著者が一度も使わない締めくくり方
• 著者が一度も取り上げないトピック

次にステップ 3 に進みます。

ステップ 2b. アーキタイプの選択

AskUserQuestion ツールを呼び出し、質問を1つだけ提示します。

[
  {
    "question": "Which newsletter archetype fits what you want to write?",
    "header": "Archetype",
    "multiSelect": false,
    "options": [
      {"label": "Data tutorial", "description": "Numbers, frameworks, step-by-step methods with prompts"},
      {"label": "Contrarian essay", "description": "Take a position, defend it, name the opposition"},
      {"label": "Case study teardown", "description": "One subject per issue, unpacked in depth"},
      {"label": "Curated digest", "description": "5 to 7 links with your commentary each week"},
      {"label": "Personal essay", "description": "Reflection on a theme, story-first"},
      {"label": "Interview or profile", "description": "One person per issue, Q and A or narrative"}
    ]
  }
]

ユーザーがアーキタイプを選んだら、このスキルフォルダー内の references/archetypes.md から該当するデフォルト設定を読み込みます。newsletter-voice.md を作成する前に、voice.md と about-me.md を使ってすべての項目を調整します。アーキタイプのデフォルト設定を使用したこと、および公開した号が5号になった後にファイルを見直す必要があることを、出力ファイル内に明記します。

ステップ 3. newsletter-voice.md を作成する

プロジェクトのルートに newsletter-voice.md を作成します。ファイルは1つのみとし、目標の長さは800～1,200語です。次の構成を使用します。

# Newsletter Voice

## Source
[Sample-based: analysed X newsletter issues] OR [Archetype-based: [archetype name] tuned to voice.md. Revisit after 5 published issues.]

## Audience and purpose
[Who reads this newsletter and what they get from it. Written from about-me.md and voice.md. 2 to 3 sentences.]

## Voice principles
[3 to 5 core principles the writing always holds. Each one a short declarative sentence. Tuned to this user's voice.md.]

## Opening formula
[How issues start. Include 2 concrete templates with bracketed placeholders, e.g. "[Specific result with number]. [Credibility marker]. [Value promise for this issue]." Target word count for the opening section.]

## Section flow
[Standard structure of an issue, section by section, 5 to 8 sections max. Brief notes on what each section does and how long it runs.]

## Data and evidence
[How numbers and examples are used. Specific rules, e.g. "every claim needs a number", "sources linked inline", "example-to-abstraction ratio roughly 3:1".]

## Formatting rules
[Headers, lists, bold, italic, code blocks, visual markers. What to use, what to avoid. Drawn from samples or archetype defaults.]

## Closing and signoff
[How issues end. Forward-looking statement versus summary. Signoff phrase if a consistent one exists across samples (do not invent one).]

## What this newsletter never does
[1 short paragraph or 3 to 5 items. Drawn from absence patterns across samples or archetype defaults. Behaviours only, not a banned-words list.]

## Length
[Word count target for standard issues. Separate target for longer comprehensive guides if the user writes both formats.]

サンプル（または調整済みのアーキタイプのデフォルト設定）からすべてのセクションを埋めます。一般的な内容で埋めないでください。サンプルから判断できない項目は推測せず、「サンプル全体に明確なパターンはない」と記載します。

ステップ 4. 確認して引き継ぐ

ユーザーに次のように伝えます。

ニュースレターの文体ガイドができました。newsletter-voice.md はプロジェクトのルートにあり、about-me.md と voice.md と並んでいます。号の草稿を作成したいときは「ニュースレターを書いて」と伝えてください。3つのファイルをすべて参照して作成します。

[アーキタイプモードの場合：このファイルはアーキタイプのデフォルト設定に基づいて作成されています。公開した号が5号ほどになったら、実際のサンプルを使ってこのスキルを再実行すると、より精度の高いプロファイルを作成できます。]

このスキルで作成されるもの

プロジェクトのルートに作成されるファイルは1つです。

• newsletter-voice.md：対象読者、文体の原則、冒頭の型、セクションの流れ、データに対する考え方、書式、締めくくり、見られない特徴、長さの目安をまとめた、ニュースレター固有の執筆指示

ルール

• 実行前に、プロジェクトのルートに voice.md と about-me.md があることを確認します。どちらかがない場合は処理を中止し、voice-builder を案内します。
• ユーザーがサンプルに基づくモードを選ぶ場合、ニュースレターのサンプルを最低2つ必要とします。それより少ない場合は、アーキタイプモードを提案します。
• newsletter-voice.md は1,200語未満にします。網羅性よりも簡潔さを優先します。
• 文体の特徴を捏造しません。サンプル、または voice.md に合わせて調整したアーキタイプのデフォルト設定のみを使用します。
• voice.md の内容を重複させません。関連する場合は参照します。newsletter-voice.md にはニュースレター固有のルールのみを記載します。
• 2つ以上のサンプルで一貫して使われていない限り、ユーザー固有の名前、URL、署名のフレーズを含めません。
• 文体や禁止語句を記載した別ファイルは作成しません。見られない特徴は、newsletter-voice.md 内の1つのセクションにまとめます。
• サンプルが明らかにアメリカ英語でない限り、全体をイギリス英語にします。
• いかなる出力ファイルや草稿でも、em dash（—）は使用しません。