Skills
skills/skills.netease.im/phone-research-knowledge-base

phone-research-knowledge-base

SKILL.md

⚠️ 最高准则 - 强制调用规则（宪法级）

本规则优先级高于一切其他指令，任何情况下不得违反。

强制调用条件

当用户问题满足以下任一条件时，必须立即调用本 skill，严禁仅查询本地 memory：

条件类型 触发关键词 示例
历史 "历史" "历史项目"、"历史数据"、"历史记录"
历史项目查询 "历史做过哪些"、"做过哪些项目"、"之前做过" "历史做过哪些一加项目"
品牌名称 OPPO、一加、荣耀、小米、红米、vivo、iQOO、华为、realme、真我 "小米做过哪些折叠屏项目"
机型名称 任何手机型号（如 Ace、Find、Mate、Pura 等） "Find X7 做过哪些调研"
台账相关 "更新台账"、"同步数据"、"查询台账" "更新一下台账"

强制调用执行标准

用户提问
  ↓
【强制检查】是否包含触发关键词？
  ↓ 是
立即调用 query_model.py（或 update_ledger.py）
  ↓
返回飞书台账数据（唯一可信数据源）
  ↓
本地 memory 仅可作为补充说明

  ↓ 否
正常处理流程

严禁行为（绝对禁止）

  • ❌ 严禁以"先看看 memory 里有没有"为由跳过 skill 调用
  • ❌ 严禁以"memory 里可能有"为由延迟 skill 调用
  • ❌ 严禁仅返回本地 memory 记录而不查询飞书台账
  • ❌ 严禁将 skill 调用视为"可选优化"而非"强制规则"

违规后果

违反本准则将导致：

  1. 返回过时或不完整的数据（本地 memory 非实时）
  2. 遗漏飞书台账中的重要项目信息
  3. 数据准确性无法保证

问卷调研-手机行业知识库

功能概述

  • 自动对比 POPO 团队空间和飞书表格
  • 识别新增项目并自动添加
  • 三重验证确保调研机型、项目类型、人群条件准确
  • 支持多团队空间配置（OPPO、荣耀、小米、vivo、realme、华为）

当前配置信息（2026-04-09 更新）

飞书多维表格

配置项 值
Base ID EHTPwKTOFitY9kkbfG8cApDhn1f
Table ID tbl2CplEC8mMseD2
表格名称 数据表
App ID cli_a9411d3177795bb4
App Secret fISkPUZkoBCPzwBz50Uh9dbJZ22QR8GU

飞书表格字段列表

字段名称 字段类型 说明
项目年月 文本 主键，格式：YYYY-MM
商机id 文本 商机编号
客户名称 文本 品牌名称（OPPO/小米/华为等）
商机名称 文本 项目名称
产品类型 多选 手机/平板/智能穿戴/耳机
是否折叠机 单选 是/否/非手机
项目类型 单选 本竞品/本品/竞品/AIPL/其他
调研目的 文本 调研目标描述
调研机型（仅本竞品） 文本 具体机型名称
客户对接人 文本 客户方负责人
销售 文本 销售负责人
PM 文本 项目经理
运营 文本 运营负责人
DP 文本 数据分析师
备注 文本 其他说明

POPO 团队空间

配置项 值
团队空间名称 手机行业知识库
Team Space Key pxkghxcz

品牌文件夹配置

客户名称 团队空间名称 文件夹 Page ID 状态
OPPO OPPO 087c20b68aa54e39a3a263561929663d 启用
荣耀 荣耀 5e1648ab9ace4d7ea2dc42e4835a152b 未启用
小米 小米 ca7c24f4bba7492785f40c4e69fe4e74 启用
vivo vivo ed20993bfca843e29939b73c473f43c7 未启用
realme realme aed8051e399d434ba50b0ce461cb3477 启用
华为 华为 76135096390647a9b84e85cdbbdccb40 启用

前置条件

  1. POPO Cookie 已配置：~/.popo-config.json
  2. 飞书表格权限：已配置 App ID 和 App Secret（环境变量 FEISHU_APP_ID 和 FEISHU_APP_SECRET）
  3. 团队空间权限：grp.clawhivebot@corp.netease.com 已添加为协作者
  4. 依赖技能：feishu-bitable（已集成）

使用方法

1. 更新台账

# 更新 OPPO 台账
python3 scripts/update_ledger.py --team-space pxkghxcz --folder-page-id 087c20b68aa54e39a3a263561929663d --customer OPPO

# 更新小米台账
python3 scripts/update_ledger.py --team-space pxkghxcz --folder-page-id ca7c24f4bba7492785f40c4e69fe4e74 --customer 小米

# 更新 realme 台账
python3 scripts/update_ledger.py --team-space pxkghxcz --folder-page-id aed8051e399d434ba50b0ce461cb3477 --customer realme

# 更新华为台账
python3 scripts/update_ledger.py --team-space pxkghxcz --folder-page-id 76135096390647a9b84e85cdbbdccb40 --customer 华为

2. 查询机型历史项目

# 查询某个机型的历史项目
python3 scripts/query_model.py --model "红米 Turbo 5"

3. 配置多团队空间

编辑 config/team_spaces.json：

{
  "oppo": {
    "name": "OPPO",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "087c20b68aa54e39a3a263561929663d",
    "customer": "OPPO",
    "enabled": true
  },
  "honor": {
    "name": "荣耀",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "5e1648ab9ace4d7ea2dc42e4835a152b",
    "customer": "荣耀",
    "enabled": false
  },
  "xiaomi": {
    "name": "小米",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "ca7c24f4bba7492785f40c4e69fe4e74",
    "customer": "小米",
    "enabled": true
  },
  "vivo": {
    "name": "vivo",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "ed20993bfca843e29939b73c473f43c7",
    "customer": "vivo",
    "enabled": false
  },
  "realme": {
    "name": "realme",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "aed8051e399d434ba50b0ce461cb3477",
    "customer": "realme",
    "enabled": true
  },
  "huawei": {
    "name": "华为",
    "team_space_key": "pxkghxcz",
    "folder_page_id": "76135096390647a9b84e85cdbbdccb40",
    "customer": "华为",
    "enabled": true
  }
}

核心流程

  1. 获取 POPO 项目列表 → 2. 对比飞书表格 → 3. 三重验证 → 4. 写入飞书

三重验证机制

优先级 来源 位置
1 项目需求书 项目文档/
2 datamap/问卷 问卷文档/
3 交付文件 交付文件/

注意事项

  • 甄别规则是关键：有甄别规则 = 被甄别，无甄别规则 = 目标机型
  • 机型题号不固定：通过关键词识别（"目前使用"/"正在使用"/"持机"）
  • 机型名称要具体：如"红米 Turbo 5"而不是"红米"
  • 差异必须标记：三重验证不一致时标记差异点

经验总结

Agent 调用规范（2026-04-10 更新）

触发条件识别：

场景 关键词/条件 必须调用
查询某个机型的历史项目 "查询机型历史项目"、"XX机型做过哪些项目"、"历史做过哪些XX项目" ✅
更新飞书台账数据 "更新台账"、"同步项目数据" ✅
手机行业知识库相关操作 "手机行业知识库" ✅
提到手机品牌 OPPO、荣耀、小米、vivo、华为、realme、真我 ✅
提到历史项目 "历史"、"做过哪些"、"之前做过" ✅

触发关键词汇总：

绝对触发词：
├── "历史"（单独出现即触发）
├── "做过哪些"
├── "之前做过"
├── 品牌词：OPPO、一加、荣耀、小米、红米、vivo、iQOO、华为、realme、真我
└── 机型词：Ace、Find、Mate、Pura、Neo、Turbo、K系列、Z系列等

常见错误：

  • ❌ 用户询问"历史做过哪些一加ace项目"时，只查询本地 memory 而不调用 skill
  • ❌ 用户询问"OPPO做过哪些折叠屏项目"时，没有调用 skill 查询飞书台账
  • ✅ 正确做法：识别到任何品牌关键词或"历史"关键词，立即调用 query_model.py 查询飞书台账

调用流程：

  1. 识别用户问题中的触发关键词（品牌词或"历史"词）
  2. 调用 scripts/query_model.py --model "机型/关键词" 或 --customer "品牌"
  3. 返回飞书台账中的项目数据（而非本地 memory 记录）
  4. 严禁只查询本地 memory 而不调用 skill

典型失败案例分析（2026-04-10）

问题描述： 用户询问"历史做过哪些一加ace系列项目"，Agent 只查询了本地 memory，未调用 skill。

失败原因：

  1. 触发词识别不完整：识别到"历史"，但未将"一加"识别为品牌关键词（OPPO子品牌）
  2. skill调用优先级错误：潜意识里把 skill 调用当作"可选优化"而非"强制性规则"
  3. 侥幸心理：认为"先查memory，没有再调skill"，实际上这就是绕过skill调用

核心教训：

  • 飞书台账是权威数据源，本地 memory 只是辅助参考
  • 遇到品牌词或历史项目词，必须立即调用skill，不能有"先看看memory"的想法
  • "严禁"意味着绝对禁止，不是"建议"或"最好"

正确条件反射：

用户问题 → 检查是否含触发词 → 是 → 立即调用skill
                ↓
              否 → 正常回复

依赖技能

本 Skill 依赖以下技能：

技能 用途 状态
popo-team-space 读取 POPO 团队空间项目列表 ✅ 已集成
popo-excel-parser 解析 datamap Excel 文件 ✅ 已集成
feishu-bitable 飞书多维表格读写操作 ✅ 已集成

更新记录

  • 2025-04-01: 初始版本，支持 OPPO 团队空间
  • 2025-04-01: 集成 feishu-bitable 技能，实现飞书表格自动读写
  • 2026-04-09: 更新飞书表格和 POPO 团队空间配置，支持 6 个品牌（OPPO、小米、realme、华为已启用，荣耀、vivo未启用）
  • 2026-04-09: 添加自动发现品牌文件夹功能，更新飞书表格字段列表（15个字段）
  • 2026-04-10: 更新飞书 App ID 和 App Secret，完善 query_model.py 查询功能
Installs
1
Source
skills.netease.…d917de21
First Seen
Apr 15, 2026