Competitor & Research Accumulation

竞品与调研知识长期积累。排版套 prd skill 通用规则（短句 ≤30、全有序序号无 bullet、标题无括号、事实与〔判断〕分列、不杜撰、不确定标待补）。

标题无括号 + 标题简洁是反复出错点：

1.1. 标题不塞备注：反面 ### 4.5 Monitors（Pro add-on），正面 ### 4.5 Monitors，备注下沉到标题下方第一行。 1.2. 标题不塞总结句：反面 #### 自动分两个队列，团队只看这两堆，正面 #### 两个队列，解释句下沉。 1.3. 标题不塞冒号 + 内容枚举：反面 #### 两个核心对象：Monitor 和 Scorecard，正面 #### 两个核心对象，对象名进正文。 1.4. 经验值：H4 标题尽量 ≤ 10 字，超过先想能不能拆掉 ", / 与 / + / 的" 后面那截。

输出路径

2.1. AI 应用 / 行业产品 → <COMPETITION_DIR>/<分类>/<产品>/_现状.md。 2.2. Agent 模块 / 框架 → <RESEARCH_DIR>/<模块|AI框架/框架>/_现状.md。

<COMPETITION_DIR> 和 <RESEARCH_DIR> 由用户在 CLAUDE.md 中配置。

〇、写给产品经理看，不写给论文读者看

文档读者是产品经理，不是论文作者。论文 / 基准 / 框架 / 模块条目一律遵守，写完不达标要重写：

3.1. 不留裸术语：英文词、论文里的代号（如 c1 / aware-tool-only）、缩写，一律翻成中文说法，并在首次出现处就地一句话解释——读者不看原论文也能懂。 3.2. 开头先给一句话：每个 #### 条目第一条用大白话 + 生活化比方说清它到底在干嘛，再展开机制。例：DecisionBench 开头先写"像主管把活分给专长不同的下属"。 3.3. 多条件对比用表格：并列的方案 / 档位 / 实验条件（如"5 种递法各得几分"），用表格，不用多层嵌套编号。 3.4. 自检：写完通读一遍，凡"不看原论文就看不懂"的句子重写；宁可啰嗦，不留黑话。

一、两类对象

4.1. AI 应用 / 行业产品 → <COMPETITION_DIR>/<分类>/<产品>/_现状.md。 4.2. Agent 模块 / 框架 → <RESEARCH_DIR>/<模块|AI框架/框架>/_现状.md。 4.3. 文件名一律 _现状.md；H1 标题不写「现状」： 1. 产品：# <产品> 汇总。 2. 模块：# Agent <模块>模块汇总。 3. 框架：# <框架> 框架汇总。

二、AI 应用产品文档（硬性）

无一例外按产品「功能菜单」梳理全部功能，类 Shulex。禁止只列「核心功能」简表。 这是高级 PM 基本功。

5.1. 有账号：登录后台按产品自身菜单逐项走查，字段级（Shulex / Intercom 范式）。 5.2. 无账号：去帮助中心 / 官方文档 / 博客反推出功能菜单，不许偷懒只写几条。Sierra 是无账号菜单化范本。 5.3. 结构： 1. 主要作用（解决什么，3 类问题）。 2. 功能菜单（产品自身导航 / 模块树，尽量全）。行业专项范式：若产品无明确系统菜单（非账号实操、靠帮助中心反推），按你所在行业的标准能力树固定顺序拆。例如客服行业：① 接入渠道 ② 机器人功能 ③ 人工功能；机器人功能再细分配置 / 问答 / 转人工 / 训练调优 / 主动外呼；人工功能含工单 / 坐席工作台 / 坐席辅助 / 质检 / 排班 / 协作 等。这套统一框架让同行业竞品可横向比；有真实系统菜单（如账号走查）则按其本身菜单，不套此框架。 3. 各模块详解（每个 #### 写 作用 / 子功能 / 说明 / 链接）。「子功能」必须列到帮助中心能查到的具体能力 / 设置项级，不许只写一句话模块描述（反面例：Zendesk「工单」只写"跟踪归类解决"不合格；正面：列出 视图 / 触发器 / 自动化 / 宏 / SLA / 字段表单 / 状态 / 旁路会话 / 路由 / 轻量坐席 …）。帮助中心一定有，必须翻出来。 4. 〔判断〕对自家产品的启示。 5. 待补。 6. 参考（链接内联在所属内容旁）。 5.4. 达不到这个菜单深度，不算完成。

三、帮助中心必须真抓，不靠通识

WebFetch 抓 JS 帮助中心多为空壳 / 404，不可靠。必须用真渲染浏览器抓：

6.1. 用 chrome-devtools MCP（默认）或可选高速工具 browser-cap（装了 BROWSER_CAP_DIR 才有）。打开帮助中心首页，evaluate 取分类 / section 导航（a[href] 滤 /categories|sections|articles/）。 6.2. 逐层导航每个 section，取全部文章标题。 6.3. 明细要求：每篇帮助中心文章 = 一个功能项，逐条列出。禁止「N 篇：一句概括」（如「Train 9 篇：训练」不合格；要列出 添加内容 / 管理内容 / 启停内容 / 同步 URL / 管理商品信息… 9 条）。文章标题即功能名，逐条进各模块详解。关键配置篇再深入正文取设置项 / 字段。 6.4. 链接填对应 section / 文章真实 URL。文章 URL 模式各站不同（Zendesk = /hc/en-us/articles/<id>，Gorgias = /en-US/<slug>-<id>，非 /articles/）—— 先 dump 全 a 看真实 href 模式再写 filter。 6.5. 找不到帮助中心 URL：先打开官网首页，取含 help / support / docs 的链接定位真实文档站（如 Gorgias = docs.gorgias.com）。 6.6. 站点纯 JS 且无公开结构化帮助中心：据官博 / 公认能力梳理 + 标待补，建议登录后台按菜单实走。

四、功能截图

7.1. 只放真实产品 UI 图：从官方文档 / 帮助中心 / 博客提取 <img> 下载，存 <产品>/screenshots/。 7.2. 整页营销首页截图无用，禁用。 7.3. 取不到就写「功能截图待补 + 建议来源 URL」，不塞废图、不杜撰。 7.4. 抓取技法： 1. 浏览器打开目标页。 2. evaluate 取页面最大内容图 src（滤掉 logo / icon / avatar / banner）。 3. curl -sL <src> -o <路径>，file 校验为 PNG/JPG。 4. 站点纯 JS 取不到图就用第 3 条。

五、账号截图：视口截图 + 等加载完成

直接抓全页 contentSize（最多 12000px），在留白多的页面 / 弹窗会出 2000px+ 长图，文档读起来像翻书。

改用 1440×900 视口截图：用 chrome-devtools MCP 的 setViewportSize 或 browser-cap 的 Emulation.setDeviceMetricsOverride 强制视口大小，截图时 captureBeyondViewport: false。

视口高度按内容决定：

8.1. 窄信息页 / 简单弹窗 = 900（一屏）。 8.2. 多卡片页（如 Shulex 数据分析 9 卡 / Intercom Deploy/Email 整页配置） = 14001800（要看全 3 行内容）。 8.3. 长滚动页（如 Knowledge 全表） = 18002400。 8.4. 别用 captureBeyondViewport: true，会把 contentSize 整个抓下来。

加载完成前不要截图（否则截到 spinner 占位 / 骨架屏）：

8.5. 导航后 sleep ≥ 5 秒（Intercom / 复杂 SPA 通常要 5–10 秒）。 8.6. 截前先 evaluate 校验：取 document.body.innerText 看是不是只有菜单 + 模块名（说明主体还在 loading），或检查 document.querySelector('[class*=spinner], [class*=loading]') 是否消失。 8.7. 截后立即 Read 看图，发现是 spinner / 白屏 / 骨架屏立刻重抓。 8.8. 弹窗截图前一步只 click 一次，不要连续 click 多个 button 触发竞态；不确定就在 click 后插入 sleep 1–2 秒再 evaluate 确认 modal 已出现。 8.9. 文件名 + 上下文匹配：弹窗 / 详情页用模块前缀（如 08c-Agent-工具详情-输入设置.png）；同一交互的多个状态用同前缀 + 状态后缀。

六、灰度 / Pro 锁住的页面走帮助中心兜底

有账号 ≠ 能看全功能。账号经常碰到：

9.1. Pro add-on 锁定（Intercom 的 Topics Explorer / Trends / Monitors / CX Score 等）—— 页面只显示 Get Pro / Learn more 介绍卡。 9.2. Managed Availability / 申请制（Intercom Fin Voice / Operator）—— 显示 "Register your interest" 占位卡。 9.3. 本工作区未启用 —— 显示"未开通"占位。

碰到这三类，立刻去帮助中心找文章补功能描述 + 截图，不要在文档里只写"未开通，能力未知"：

9.4. 找路径：<官网>/help/en/?q=<关键词> 搜，看返回链接里 /articles/<id>-<slug> 是不是相关功能名。 9.5. 抓文章：浏览器打开文章页，取 (document.querySelector('article, main, [class*=article]')||document.body).innerText 全文。 9.6. 抓 UI 截图：取 article img.src，过滤掉 icon / avatar / logo + 只留 CDN 域（如 intercomcdn、zdusercontent），curl -sL <src> -o <路径>，file 校验 PNG。 9.7. 在文档对应章节加标记：标题后注明「Pro add-on / 灰度，本账号未开通；据帮助中心补充」，让读者一眼知道这段不是亲测，是文档反推。 9.8. 末尾内联参考链接（如 参考：[原文标题](url)），可溯源。 9.9. 帮助中心常带真实 UI 截图 / GIF / 视频链接，比账号空壳页信息密度高得多——别图省事写"未开通"草草交差。

七、日志按日期分节维护

每次重抓（结构性变更 / 新功能上线）写入 _现状.md 末尾「更新日志」章节：

10.1. 顶部加「最新更新摘要」表（H1 下方），| # | 模块 | 变化 | 三列，只列本次变化。 10.2. 末尾「更新日志」章节，每个爬取日期一个 ### YYYY-MM-DD 子标题，下方一张同结构表。 10.3. 只记功能变化，不记工程化操作（如截图工程修复、文件大小优化）。 10.4. 不用 §X.X 模块编号做引用——文档章节会动，编号易失效；只写模块名（如「工具详情」「数据分析」）。

八、Agent 模块汇总（<RESEARCH_DIR>/<模块>/）

11.1. 结构：主要作用 → 当前主要模式 → 主要方法 → 关键设计维度 →〔判断〕→ 待补 →（研究类保留参考）。 11.2. 主要方法：对照轴（载体 / 管理者 / 写入 / 检索 / 部署 / 适用）并一张总表，不拆两张；每方法另设详解 ####；使用流程写业务视角（客户 / Agent 怎么跑），不写安装 / 初始化 / API。 11.3. 「研究范式 / 论文机制」与框架详解同构：每篇 #### = 定位 / 核心机制 / 关键步骤 / 影响 / 适用·局限 / 链接。 11.4. 链接一律内联在所属内容旁；参考节只留索引指针，不堆链接。

九、框架深挖（<RESEARCH_DIR>/AI框架/<框架>/）

12.1. 结构：主要作用 →（家族成员，如 LangChain 家）→ 整体架构 → 核心模块 → 核心机制 → 编排模式 → 与同类对比 →〔判断〕→ 待补 → 参考。 12.2. 核心模块每个 #### 写 作用 / 关键对象 / 机制 / 用法 / 链接（用法后必带链接；官方深链不确定指文档站根，深链精化入待补，不杜撰 404）。 12.3. 整体架构要有图：能拿官方架构图就下载嵌入；拿不到就自绘 ASCII 分层框图。 12.4. AI 框架目录另有 _框架对比.md：横向能力表 + 选型场景表 +〔判断〕。

十、主题分流与增量

13.1. 实践文章按主题归对应模块，不硬塞记忆 / 不混模块。判断不清列选项让用户拍板。 13.2. 推荐分流：定时调度 / 自主运行 → <RESEARCH_DIR>/AI框架/自主执行/；RAG / GraphRAG → <RESEARCH_DIR>/RAG/；评测 → <RESEARCH_DIR>/评测/；运行骨架 → <RESEARCH_DIR>/harness/。 13.3. 增量：每日调研查到新方法 / 版本 / 案例，插入对应模块已有小节，不另起散文。 13.4. 实践小节分 ### 国内 / ### 海外，每条 = 主体 + 怎么用（编号短句）+ 特征 + 链接。常备源：微信技术号、Anthropic engineering、OpenAI、各厂帮助中心。

十一、交付前自检

14.1. AI 应用：是否按菜单梳理了全部功能（达 Shulex / Sierra 深度），不是简表。 14.2. 功能截图：是真实 UI 图或明确待补，无营销整页废图，无失效引用。 14.3. 截图视口尺寸合理（不是 2000px+ 长图、不是 spinner / 骨架屏）；截后逐张 Read 验证。 14.4. H1 用「汇总」，无「现状」；标题无括号；全有序序号无 bullet；短句 ≤30。 14.5. 事实与〔判断〕分列；不确定进待补，不杜撰。 14.6. 链接内联在所属内容旁。 14.7. 无裸术语 / 代号；论文 · 基准 · 框架条目开头有大白话一句话；多条件对比用表格（见〇）。 14.8. 多次重抓的产品：H1 下方有「最新更新摘要」表，文末「更新日志」按日期分节；只记功能变化。 14.9. 遇 Pro / 灰度 / 未开通页：必须走帮助中心兜底（功能描述 + UI 截图），不能只写"未开通，能力未知"；标题注明"据帮助中心补充"。