Katib — ウェブサイトコピーライティングスキル
「AIマーケットリサーチスプリント」(ChatGPT用に作成)をエージェントワークフローに適合させたものです。
全ステップの基本ルール:議論が先、言葉は後 — ステップ1の前に references/argument-first.md を読んでください。
固定順序(スキップ不可、順序変更不可)
0 インプット → 1 参照レビュー → 2 リサーチ → 3 アバター → 4 オファーブリーフ → 5 ビリーフ → 6 ウェブサイトコピー → 7 最終チェック
パス
- スキルファイル: このスキルのベースディレクトリからの相対パス(スキル読み込み時に表示)。Redditツールは
tools/reddit_fetch.py— 研究者にはその絶対パスを渡してください。 - クライアントフォルダ:
<カレントプロジェクトルート>/katib-clients/<クライアントスラッグ>/に以下のファイルを含めます:00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md
各ステップはその前のファイルを読み込みます。フォルダが既に存在する場合はそれを読み込み、最初に欠けているファイルから再開します (または、ユーザーが指定したステップのみ再実行します)。
ステップ
セットアップ(初回実行時、および失敗時) — PinchTabを確認: pinchtab --version と pinchtab health。
ない場合やサインインしていない場合 → リサーチの前に、ユーザーに references/setup-pinchtab.md をステップバイステップで案内します。
既に動作している場合は何も言わずに続行します。
0. インプット — 欠けている情報を1メッセージで尋ねます:
製品(何か、価格(既知の場合))、オーディエンス、市場/国、出力言語(アラビア語湾岸方言 / アラビア語標準 / 英語 / 両方)、
参照ページのスクリーンショット(またはURL)、ブランドが既に持っているもの(レビュー、証拠、保証、ストーリー)があればそれも。
00-input.md を書き出します。
1. 参照レビュー — references/sales-page-review.md に従います。01-reference-review.md を書き出します。
⏸ ゲート: 判定結果 + セクションマップ + 何を借用するかを表示します。OKを待ちます。
2. リサーチ — references/research-method.md と references/research-agents.md に従います。
5つのリサーチャーを並行して起動し(R1~R4 + R5 Reddit)、結果を templates/research-doc.md → 02-research.md にマージします。
Instagram、TikTok、およびサインイン済みのRedditはPinchTabのresearchプロファイル(読み取り専用)経由で読み取ります。フォールバック:ユーザーのサインイン済みChrome(独自タブ)、次にScrapling。現地市場が薄い場合は、R1とR5は同じ種類のビジネスを世界中に広げ、その引用に国名をタグ付けします。
その後、ユーザー向けに 02-research-summary.md を書き出します:ユーザーの言語で、絵文字つきの見出しを使った短いセクション
(誰が / 夢 / 痛み / 非難 / ビリーフ / ベストストーリー / 競合 / メカニズム候補 / 警告 / ギャップ)、各セクションに[S#]付きの重要な引用を1~3つ。
⏸ ゲート: サマリーブロックと薄いセクションを表示します。OKを待ちます(ユーザーがさらに掘り下げを依頼する場合があります)。
3. アバター — 02-research.md のみから templates/avatar.md を埋めて 03-avatar.md を書き出します。
ビジネスバイヤー → 「月次収益」、消費者 → 「収入 / 支出力」。ゲートなし、ステップ4と一緒に表示します。
複数のセグメントがある場合 → セグメントごとに1つのアバターファイル(03-avatar-<セグメント>.md);ユーザーがどれをコピーの先頭にするか指定します。
ポジショニングオプション(オプション、ユーザーから依頼があった場合) — creator-toolkit:personal-brand-expert スキルをブランドに対して実行します
(ビジネスでも機能します)。02-research.md とアバターを使用します。複数のオプションとともに 03b-positioning.md を書き出し、
ユーザーの選択がステップ4のビッグアイデアに反映されます。
4. オファーブリーフ — references/offer-brief-guide.md に従い、順番に templates/offer-brief.md を埋めて → 04-offer-brief.md を書き出します。
⏸ フィールド6の後のゲート: UMP、UMS、ビッグアイデアそれぞれについて3つのオプションを提示。ユーザーが選択。その後、フィールド7~20を完了します。
5. ビリーフ — references/beliefs.md に従います → 05-beliefs.md を書き出します。
⏸ ゲート: ユーザーがコピー作成前にビリーフを承認します。
6. ウェブサイトコピー — references/website-copy.md に従い、templates/website-copy.md を埋めて → 06-website-copy.md を書き出します。
7. 最終チェック — references/website-copy.md のパス4を実行し、コピーとともに
「ブランドからの証明が必要」リストと未解決の質問を表示します。⏸ ユーザーが承認するか、変更を依頼します。
厳格なルール
- 絶対に発明しない 引用、レビュー、数字、研究、人物、価格、保証を。不足している場合は → 尋ねるかフラグを立てる。
- すべてのリサーチ引用は、開かれたURL付きの逐語引用。アバター引用はリサーチドキュメントからの
[S#]を引用。 - 参照ページから文をコピーしないこと。構造のみを借用する。
- ユーザーが依頼した言語でコピーを書く。平易な言葉、短い文。
- 健康、金融、法的な主張はコンプライアンスのためにフラグを立てる。
- ユーザーとはその言語(通常は湾岸アラビア語)で、短くシンプルに話す。スキルファイルは英語のまま。
後日:広告
まだ構築されていません。依頼があった場合、04-offer-brief.md と 05-beliefs.md を再利用(1つのビリーフまたはビッグアイデアを広告ごとに)。新たなリサーチは行いません。