algolia-autocomplete-algolia-skills

1. 基本信息

项目	内容
名称	algolia-autocomplete（algolia/skills 仓库内子技能）
作者/维护者	Algolia（GitHub 官方组织账号，多名内部工程师协作提交）
来源链接	https://github.com/algolia/skills/tree/main/skills/algolia-autocomplete
许可证	MIT（数据来自 GitHub API）
GitHub Stars	9（数据来自 GitHub API，为整个 algolia/skills 仓库的数字，不代表本技能个体热度）
Forks	3（同上，仓库级数字）
最新版本	v0.5（数据来自 SKILL.md 内 `metadata.version` 字段，本仓库未使用 GitHub Releases）
安装方式	Claude Code 插件市场 / npx / git clone 三种，见第 10 章

2. 功能介绍与亮点

algolia-autocomplete 是 Algolia 官方“实施规划套件”中的一个专项方法论技能，聚焦搜索框输入建议（自动补全 / typeahead）这一具体场景，教 Agent 在写代码前先做好三件事：定义每类建议来源的选择契约（触发方式、来源索引、跳转目的地、事件归因）、区分“查询建议”与“直接结果”两类建议的呈现逻辑、并按键盘/触屏/移动端等待验清单验收体验质量。

核心亮点：

客户就绪标准：附带 5 项验收标准（有用、清晰、聚焦、移动可用、可访问），明确“技术上能跑通”不等于“用户体验合格”
配套参考手册：references/autocomplete-guide.md 长达 228 行，含“官方技能分工表”（说明本技能只管体验设计，具体框架 API 交给官方 instantsearch 技能）
自带评测集：evals/evals.json 用真实场景提示词 + 预期输出定义验收标准，属技能仓库中较少见的自建质量保证机制
边界清晰：SKILL.md 开头即用“Do NOT use for…“明确排除结果页、筛选分页等场景，避免与同仓库其他技能功能重叠

3. 适用场景

固定分类：前端与设计

为电商、内容或文档网站实现搜索框自动补全/输入建议功能的前端开发者
需要在上线前系统检查自动补全体验（键盘导航、移动端遮挡、事件埋点）的产品或 QA 人员
已用 Algolia InstantSearch 搭好结果页、现在要单独打磨输入建议面板的团队

4. 跨 Agent 兼容性

Claude Code：原生支持——README 给出插件市场安装命令与 ~/.claude/skills/ 目录说明
Codex：原生支持——README 明确列出 ~/.codex/skills/ 为 OpenAI Codex 的技能目录
OpenClaw：未验证——README 未提及，仓库本身采用标准 SKILL.md 格式，理论上可手动复制安装，但未见官方说明
Hermes Agent：未验证——同上，README 未涉及

5. 推荐理由

Algolia官方出品的自动补全体验方法论技能，把“能不能跑起来”和“好不好用”分开管理：先用它定好来源策略、选择行为和事件归因，再交给官方 instantsearch 技能写代码，最后回来对照验收清单做上线前 QA，避免团队把自动补全做成“技术上连通但体验混乱”的半成品。

6. 评分

维度	分数	说明
受欢迎程度	7	仓库为 Algolia 官方组织出品，但整仓库仅 9 stars；子技能提交记录里活跃的是多名内部工程师而非外部社区，GitHub 上未见外部 issue 或独立第三方评价
可用性	9	插件市场一条命令安装；SKILL.md + 228 行参考手册 + 结构化评测集三件套文档完整；最近一次仓库推送在数日内；技能自身运行不依赖任何付费 API
安全性	9	见下方检查清单

安全检查清单：

shell 命令及权限范围：无——技能目录内仅 SKILL.md、参考文档与评测 JSON，无可执行脚本
联网外发数据：无——技能本身不发起任何网络请求，实际调用 Algolia API 由用户另装的官方 instantsearch/MCP/CLI 技能负责
API Key/凭据：不涉及——本技能不要求任何凭据
可疑指令：未发现——全文为方法论指导与验收清单，未见诱导 Agent 执行越权操作的措辞
作者/组织信誉：Algolia 为知名搜索服务商，仓库挂在其官方 GitHub 组织下，多名具名工程师协作维护
License：MIT，明确
最近维护时间：仓库最近一次推送在数日内，含本技能所属的“实施规划套件”整批新增，属活跃维护

7. 跟同类 Skills 相比的优势

竞品	定位	与 algolia-autocomplete 的差异
instantsearch（algolia/skills 同仓库）	官方 InstantSearch 库的框架级实现细节（React/Vue/JS 组件、API、渲染器）	负责“怎么写代码”；本技能负责“该不该这样设计、体验是否合格”，两者按官方文档明确分工衔接，不重叠
algolia-ui-libraries（algolia/skills 同仓库）	在 InstantSearch.js / React / Vue / 移动端 SDK 等多个 Algolia 前端库之间做选型的活参考手册	解决“该用哪个库”的选型问题，粒度更宏观；本技能只聚焦自动补全这一个功能点的体验设计细节
algolia-instantsearch-ui（algolia/skills 同仓库）	结果页、分类页、筛选分页等“用户已提交搜索”之后的体验规范	覆盖的是搜索旅程的下一阶段；本技能覆盖用户“还未提交搜索、正在输入”阶段的建议面板设计

8. 用户评价

该技能所在仓库目前未见 GitHub 之外的第三方具名用户评价，仓库 Issue 区也暂无外部用户就该技能提出的反馈。

9. 其他补充

该技能是 Algolia “实施规划套件”（11 个协同技能）的一员，入口技能 algolia-discovery-planning 会根据任务阶段自动加载包括本技能在内的相应配套技能；单独安装本技能同样可独立使用。

10. 安装使用方式

# 方式一：Claude Code 插件市场（推荐）
/plugin marketplace add algolia/skills
/plugin install algolia-autocomplete@algolia-skills

# 方式二：npx 一键安装
npx skills add https://github.com/algolia/skills

# 方式三：手动克隆复制
git clone https://github.com/algolia/skills.git
cp -r skills/algolia-autocomplete <你的技能目录>
# Claude Code: ~/.claude/skills/  Codex: ~/.codex/skills/

安装后需重启 Agent（或按各平台机制重新加载技能）以完成注册，下次涉及自动补全/输入建议的对话中会自动触发。

11. 注意事项

本技能不含任何具体框架代码实现细节，需与官方 instantsearch 技能配合使用才能落地到 React/Vue/JS 代码
README 明确要求 Autocomplete 包的当前 API 以官方文档与 instantsearch 技能为准，本技能内容不作为 API 版本参考
仓库整体星数与外部社区反馈都还很有限，技能的长期维护节奏有待观察