Katib — 网站文案写作技能
改编自“AI市场调研冲刺”（为ChatGPT对话编写）的代理工作流。
每一步的核心规则：论点优先，文字最后 — 在步骤1之前阅读 references/argument-first.md。
固定顺序（切勿跳过或重新排序）
0 信息收集 → 1 参考页面分析 → 2 调研 → 3 客户画像 → 4 报价简报 → 5 信念 → 6 网站文案 → 7 最终检查
路径
- 技能文件：相对于此技能的基础目录（技能加载时显示）。Reddit工具是那里的
tools/reddit_fetch.py— 给研究人员提供其绝对路径。 - 客户文件夹：
<当前项目根目录>/katib-clients/<客户-slug>/，包含：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. 信息收集 — 在一次消息中询问任何缺失的信息：
产品（是什么，价格（如已知）），受众，市场/国家，输出语言（海湾阿拉伯语 / 现代标准阿拉伯语 / 英语 / 两者），
参考页面截图（或URL），品牌已有的任何内容（评论、证明、保证、故事）。
写入 00-input.md。
1. 参考页面分析 — 遵循 references/sales-page-review.md。写入 01-reference-review.md。
⏸ 关卡：显示评估结果 + 章节映射 + 可借鉴的内容。等待确认。
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：使用用户的语言，带表情符号标题的简短章节
（谁 / 梦想 / 痛苦 / 指责 / 信念 / 最佳故事 / 竞品 / 机制候选 / 警告 / 空白），每个1-3个关键引用并附上 [S#]。
⏸ 关卡：显示摘要块和薄弱章节。等待确认（用户可能要求进一步挖掘）。
3. 客户画像 — 仅从 02-research.md 填充 templates/avatar.md → 03-avatar.md。
企业买家 → “月收入”；消费者 → “收入/消费能力”。无关卡；与步骤4一起显示。
多于一个细分市场 → 每个细分市场一个画像文件 (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 的第四遍，然后显示文案、
“需要品牌提供证据”列表和未解决的问题。⏸ 用户批准或要求修改。
硬性规则
- 绝不编造 引用、评论、数字、研究、人物、价格或保证。缺失 → 询问或标记。
- 每条调研引用都是原文，并附有访问过的URL。客户画像引用需注明调研文档中的
[S#]。 - 绝不从参考页面复制句子；仅借鉴结构。
- 使用用户要求的语言撰写文案。使用平实的词语、简短的句子。
- 标记健康、金融和法律声明以供合规审查。
- 使用用户的母语（通常是海湾阿拉伯语）与用户沟通，简短明了。技能文件保持英文。
后续：广告
尚未构建。当被问及时，重用 04-offer-brief.md 和 05-beliefs.md（每条广告一个信念或核心创意）。无需新的调研。