1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | algolia-data-modeling（属 algolia/skills 仓库内“Algolia 实施规划套件”子技能） | GitHub API |
| 作者/维护者 | Algolia 官方（algolia/skills 组织仓库，提交者 itsdanwilli） | GitHub API |
| 来源链接 | https://github.com/algolia/skills/tree/main/skills/algolia-data-modeling | — |
| 许可证 | MIT | GitHub API + SKILL.md 声明 |
| GitHub Stars / Forks | 9 / 3（合集仓库整体数字，不代表本技能自身热度） | GitHub API（认证取数） |
| 最新版本 | 0.5（SKILL.md metadata 内声明） | SKILL.md |
| 安装方式 | Claude Code / Codex 插件市场，或直接复制技能目录 | 官方 README |
2. 功能介绍与亮点
algolia-data-modeling 是 Algolia 官方“实施规划套件”中专门负责索引记录设计的一环。它把接入 Algolia 时容易凭直觉带过的决策——记录该对应产品还是变体、objectID 怎么取、哪些字段做搜索/过滤/展示/排序——变成一份显式的“索引契约”，并逐条给出取舍依据。
核心亮点：
- 电商变体建模三选一：区分“变体级”“变体分组”“主商品”三种记录模式，分别说明对相关性、聚合分析、更新成本的影响。
- 反模式清单：列出常见错误，如用精确库存数代替库存分桶导致每次销售都要重新索引、用高精度指标做首位排序权重导致后续业务权重形同虚设。
- 职责边界清晰：SKILL.md 正文明确“不做”实时导入/导出/账户操作/前端 UI 实现，这些交给同仓库的
algolia-cli、algolia-mcp、algolia-autocomplete等配套技能，自己只管数据形状决策。 - 成熟度分层：给出 Beginner / Production readiness / Optimization / AI readiness 四档产出标准，同一份技能能陪伴项目从原型走到生产。
3. 适用场景
固定分类：数据分析与可视化
适合已经选定（或正在评估）Algolia 作为搜索引擎、需要把业务数据库表结构转换成搜索友好的索引记录的开发者与实施顾问，尤其是电商场景（SKU/变体/多地区/多语言）下容易在记录粒度上返工的团队；也适合负责给业务方讲清楚“为什么新品/畅销榜不能靠规则凭空变出来，得先有对应字段”的技术负责人。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 提供插件市场安装命令与 ~/.claude/skills/ 目录说明 |
| Codex | 原生支持 | README 提供 ~/.codex/skills/ 目录说明及市场安装命令 |
| OpenClaw | 未验证 | README 未提及 OpenClaw（仅提及 Cursor、OpenCode，与 OpenClaw 是不同项目，不可混用作证据） |
| Hermes Agent | 未验证 | 抓取材料未提及 |
5. 推荐理由
官方技能，把 Algolia 索引记录设计的隐性决策显式化，帮助团队少走后期重建索引的弯路
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体仅 9 stars/3 forks；该技能自身仅由官方账号一次批量提交（PR #33）加入，暂无独立第三方 issue/PR 讨论 |
| 可用性 | 9 | SKILL.md 结构清晰、workflow/checklist/反模式/交付物一应俱全，另附独立的 data-modeling-guide.md 与 example-output.md 参考文档；插件市场一条命令或直接复制目录即可用；仓库最近一次推送在近期，维护活跃 |
| 安全性 | 9 | 纯提示词/指导类技能，正文未见任何 shell 命令、网络请求或凭据存取；MIT 许可证明确；官方组织账号出品，无来历不明的权限索取 |
安全检查清单： ① 无 shell 命令执行；② 无运行时联网外发；③ 不涉及 API key/凭据；④ 未见可疑指令或混淆内容；⑤ 官方 Algolia 组织账号，无造假迹象；⑥ MIT 许可证明确；⑦ 仓库近期仍有推送，非弃置项目。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| algolia-autocomplete（同仓库） | 负责自动补全/联想词的来源策略、选择契约与 QA | 处理的是前端交互层的搜索建议逻辑，不涉及底层记录该怎么建模 |
| instantsearch（同仓库） | 用 InstantSearch 库搭建搜索结果页、分面筛选等前端 UI | 关注 UI 组件与交互实现，假设记录已经建好；本技能恰好补上它假设成立的前置环节 |
| 通用数据库表结构设计类技能 | 面向关系型数据库的规范化建模 | 通用建模强调范式化、避免冗余；本技能反其道而行，主张为搜索场景做反范式化的记录设计，两者解决的问题方向相反，不可互相替代 |
8. 用户评价
该技能于 2026-07-28 随“Algolia 实施规划套件”一并加入官方仓库，截至目前第三方平台尚无独立的具名用户评价。
9. 其他补充
该技能是 11 个技能组成的“algolia-implementation”套件的一部分，官方文档建议整体安装以获得从需求梳理（algolia-discovery-planning）到发布 QA（algolia-release-qa）的完整规划链路；也可以只复制 algolia-data-modeling 单个目录独立使用，仅在记录设计阶段调用。
10. 安装使用方式
插件市场（推荐）：
/plugin marketplace add algolia/skills
/plugin install algolia-implementation@algolia-skillsnpx：
npx skills add https://github.com/algolia/skills手动复制（仅需数据建模这一环时）：
git clone https://github.com/algolia/skills.git
cp -r skills/algolia-data-modeling ~/.claude/skills/复制后需重启 Agent 使其加载新技能；技能触发依赖描述文本中的场景关键词（索引、record、variant、facet 等），无需额外参数配置。
11. 注意事项
- 该技能只负责“决策与规划”，不执行任何实际的索引创建、数据导入或设置变更——真正落地操作需要配合官方
algolia-cli或algolia-mcp技能使用 - SKILL.md 建议在关键决策前主动索取业务方提供的样例记录与边界案例，若使用者跳过这一步直接生成记录方案，产出质量会明显打折
- 当前版本号为 0.5，仍处于早期迭代阶段，后续字段命名或建议细节可能调整