setup-copywriting-md

COPYWRITING.md のセットアップ

概要

一度限りのセットアップです。このプロジェクトのコピーとカテゴリーに関するメッセージを調査し、エージェントと人間が参照できるルートの COPYWRITING.md を1つ作成します。ユーザーからファイルの再生成や更新を明示的に依頼されない限り、継続的なメンテナンススキルとして扱わないでください。

出力

• リポジトリのルートに COPYWRITING.md を1つだけ作成します。
• COPYWRITING.md がすでに存在する場合は、上書き、統合／更新、中止のどれにするかを一度だけ尋ねます。黙って上書きしてはいけません。

ワークフロー

1. プロジェクトのコンテキストを収集する

製品、対象ユーザー、既存の文体を理解できるだけの情報を読みます。

• ルートのドキュメント：README.md、ランディングページ／マーケティングページ、概要／料金ページ、オンボーディングのコピー。
• 製品内の文言：UI ラベル、空の状態、エラー、メール、通知、CTA のパターン。
• ブランドやスタイルに関するメモがあれば参照します（存在しないブランドブックを捏造してはいけません）。
• 位置づけが分かるパッケージのメタデータ、サイト設定、公開 URL。

推測よりもリポジトリ内の一次情報を優先します。

2. 外部のパターンを調査する

利用可能な場合は、設定済みの調査ツールやウェブツールを使います。利用できない場合は、一次情報を検索して開きます。

• 直接の競合製品や有力な代替製品（ホームページ、料金、機能ページ、オンボーディング）。
• 明確なメッセージを発信するカテゴリーのリーダーや、隣接分野の優れた製品。
• 繰り返し見られる構成を記録します。見出しの形式、根拠を示すパターン、CTA の動詞、懸念への対処、トーンなどです。

具体的な例（短い引用＋URL）を記録します。観察されたパターンと推奨するパターンを区別します。

3. ユーザーにヒアリングする（不足分のみ）

リポジトリや調査からは分からないことだけを尋ねます。質問はまとめて行います。情報が不足している場合は、次の点を確認します。

• 意図するブランドボイス（使用する／避ける言葉）。
• 譲れない主張、コンプライアンス、法的制約。
• 希望する言語／ロケールと敬語のレベル。
• 対象範囲から除外する必要がある製品や画面。

ユーザーがヒアリングを断った場合は、前提を明記して進めます。

4. COPYWRITING.md を作成する

references/template.md を使います。該当するセクションはすべて記入し、空のセクションは省略します。品質基準：

• 一般的なマーケティングアドバイスではなく、この製品に具体的に即した内容にします。
• 短い実例または現実的な例を使って、やるべきこと／避けるべきことを記載します。
• 事実（現在のコピー）と指針（推奨パターン）を分けます。
• 必要に応じて、使用した競合製品／情報源と日付または URL を記載します。
• 別のエージェントが再調査せずにブランドに沿ったコピーを書けるほど、実行可能な内容にします。

5. AGENTS.md からリンクする（条件付き）

COPYWRITING.md の作成後：

1. ルートの AGENTS.md だけを確認します。
2. 存在しない場合は、リンクの追加を省略します。AGENTS.md を作成してはいけません。
3. 存在する場合は、リンクがなければ COPYWRITING.md への分かりやすい案内を追加します。
   • 既存の「目次」「ドキュメント」「関連ドキュメント」セクションを優先します。
   • そのようなセクションがなければ、## Project docs のような短いセクションと、次の箇条書きを追加します。 - [COPYWRITING.md](COPYWRITING.md) — voice, tone, and copy patterns
   • コピーライティングの内容全体を AGENTS.md に重複して記載してはいけません。
   • 関係のない AGENTS.md の内容はそのまま保持します。

6. 完了を報告する

• 作成したパスを確認します。
• 簡単な要約を記載します。ブランドボイスを1文で説明し、重要なルールを3つ挙げ、AGENTS.md を更新したか、更新を省略したかを伝えます。
• ユーザーから依頼されない限り、コミットしてはいけません。

独立性

このスキルは単独で機能します。他のスキルについて言及したり、リンクしたり、依存したりしてはいけません。参照できるのは、リポジトリ内のファイル、外部情報源、およびこのスキルの references/ のみです。

対象外

• コードベース内のすべての製品コピーを書き直すこと。
• ブランドブック、デザインシステム、マーケティングサイト全体を作成すること。
• 存在しない AGENTS.md を作成すること。
• ユーザーからセットアップの再実行を依頼されない限り、定期的な監査を行うこと。