与 AI 编码代理集成
k-ID 发布了一套官方的 Agent Skills — 小巧、可组合的指令包，用于教 AI 编码代理如何在 k-ID 支持的所有司法管辖区域内正确集成 k-ID。它们覆盖 COPPA（美国）、GDPR-Kids（欧盟）、英国 AADC、英国《在线安全法》（Online Safety Act）、巴西 ECA Digital、澳大利亚《在线安全法》/社交媒体最低年龄等地区性要求。它们适用于 35 多种 AI 工具，包括 Claude Code、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLI，以及任何遵循开放 Agent Skills 规范的代理。
技能托管在 github.com/kidentify/skills。
两种集成形态
这些技能同时支持 k-ID 的两种集成形态。路由技能会从用户请求中识别适用的形态,并仅加载该形态所需的技能。
- 形态 A — 完整会话集成。年龄门 → 会话 →（同意 | 年龄验证 | 阈值）→ 权限。适用于需要持久化按用户状态和多个门控功能的游戏、社交平台和多功能应用。使用 5–7 个技能。
- 形态 B — 独立 AgeKit+。一次调用
/age-verification/perform-access-age-verification,一个让用户完成年龄验证的 iframe,以及 webhook 或轮询获取结果。没有年龄门、没有会话、没有权限。适用于 18+ 站点（英国 OSA）、年龄限制下载、澳大利亚社交媒体最低年龄检查或任何单次年龄证明决策。使用 2–3 个技能。
自定义集成中的两种 UI 方法
在形态 A 中，k-ID 提供了两种渲染年龄门和家长同意流程的方法，技能两者都涵盖。权威比较请参阅选择集成方式。简要如下：
- 自定义 UX 流程（默认） — 自行构建年龄门和同意界面，并直接调用
/age-gate/check、/challenge/send-email等。可提供最佳外观、与品牌最一致的体验，以内联方式渲染（不使用 iframe），并在 k-ID 支持的所有平台（Web、Unity WebGL、游戏主机、原生桌面）上可用。推荐用于生产集成。 - 小部件（快速回退方案） — 由 k-ID 发布的预构建 iframe，覆盖年龄门、端到端流程（年龄门 + 家长同意 + 数据通知 + 权限 + 家长偏好）、权限管理和数据通知。它们按司法管辖区适配年龄采集方式，在需要时自动触发家长同意挑战。当集成必须做到小而简单、并尽快上线时（PoC、内部工具、早期游戏等）选择此项。
k-id-age-gate 和 k-id-consent-and-challenges 两个技能都同时记录了自定义路径（模式 A）和小部件路径（模式 B）。只需告诉代理您想要什么，它会选对路径。
技能包含的内容
八个可组合的聚焦技能：
| 技能 | 教给代理的内容 | 形态 |
|---|---|---|
k-id-integration | 路由器 — 识别形态并选择正确的姐妹技能 | 两者 |
k-id-age-gate | 使用调用 /age-gate/check 的完全自定义滑块（模式 A — 默认，外观和品牌集成最佳），或使用 k-ID 的年龄门小部件（模式 B — 需要小而简单、快速上线时的轻量回退）构建年龄门 — 形态 A 的入口 | A |
k-id-consent-and-challenges | 由 GUARDIAN 管理的未成年人家长同意 — 带 QR + OTP + 邮件 + 直接链接的自定义同意页面以及在模态框之外、应用顶层进行的轮询（模式 A — 默认），或端到端/权限管理小部件（模式 B — 轻量回退） | A |
k-id-age-verification | 年龄验证与年龄保证 — 独立 AgeKit+（模式 1）、会话中未验证成人（模式 2）、按权限的 verifiedAgeThreshold 流程（模式 3，英国 OSA 18+、巴西 ECA Digital、澳大利亚社交媒体最低年龄等） | 两者 |
k-id-sessions-and-permissions | 会话处理、权限门控的 UI 控件、/session/upgrade 流程形态以及 verifiedAgeThreshold 处理 | A |
k-id-webhooks | 针对原始请求体的 HMAC-SHA256 签名验证、幂等性、事件处理器 | 两者 |
k-id-server-trust-boundary | API 密钥放置、服务端代理、发布前检查 | 两者 |
k-id-mobile-native | iOS / Android / Unity 平台年龄信号和应用内浏览 | A（通常） |
当代理激活 k-id-integration 时,它会读取用户的任务并引入正确的功能性和横切性技能组合 — 您不需要单独安装它们。
安装前
- 您需要在 Compliance Studio 中拥有一个带有 API 密钥和 webhook 密钥的 k-ID 产品。参阅 API 身份验证指南。
- 技能参考的 API 请求/响应形状来自本文档站点。如果您已阻止 AI 代理的出站网络访问,请放行
docs.k-id.com。
按工具安装
以下所有安装路径都会将相同的 8 个技能放入代理上下文。选择与您工具匹配的行。
Claude Code（最快）
在 Claude Code 中运行：
/plugin marketplace add github.com/kidentify/skills
/plugin install k-id-skills@kidentify
此插件会一次性注册全部 8 个技能。用 /plugin list 确认。请用 git 形式（github.com/... 或 https://github.com/...）添加 marketplace。若出现 plugins[].source 的 schema 错误，请检查技能仓库 .claude-plugin/marketplace.json 中每个插件的 source 是否为以 ./ 开头的相对路径（见 Claude Code 插件 marketplaces）。
Cursor
将仓库的 skills/ 放到项目的 .agents/skills/（或 .cursor/skills/）。项目级技能从这些路径自动发现；用户级可用 ~/.agents/skills/ 或 ~/.cursor/skills/。参见 Cursor Agent Skills。
mkdir -p .agents/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* .agents/skills/
rm -rf /tmp/k-id-skills
重新加载 Cursor 并打开对话以确认代理的可用工具中出现这些技能。大多数情况下,Cursor 无需重启即可识别新技能。
OpenAI Codex / Codex CLI
Codex 会从当前工作目录向上到仓库根的 .agents/skills/，以及用户范围的 ~/.agents/skills/ 发现技能（OpenAI 对 Codex CLI / IDE 扩展的说明）。~/.codex/skills/ 可能仍被兼容读取，但不是主要位置。按项目安装与上文 Cursor 相同；全局如下：
mkdir -p ~/.agents/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* ~/.agents/skills/
rm -rf /tmp/k-id-skills
GitHub Copilot / Visual Studio Code
Visual Studio Code 中的 GitHub Copilot 从 项目路径 .github/skills/、.claude/skills/ 或 .agents/skills/ 加载技能（在 Visual Studio Code 中使用 Agent Skills）。个人技能可放在 ~/.copilot/skills/、~/.claude/skills/ 或 ~/.agents/skills/。将仓库的 skills/ 目录复制到你选择的项目路径；与 GitHub 文档一致时优先使用 .github/skills/：
mkdir -p .github/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* .github/skills/
rm -rf /tmp/k-id-skills
在 Chat 中用 /skills 确认是否列出。若使用非默认根目录，可通过 chat.agentSkillsLocations 配置。
Gemini CLI
Gemini CLI 在 用户层从 ~/.gemini/skills/ 或 ~/.agents/skills/ 发现技能，在 工作区层从 .gemini/skills/ 或 .agents/skills/ 发现（同一层级时 .agents/skills/ 优先）。参见 Gemini CLI Agent Skills。全局安装示例：
mkdir -p ~/.gemini/skills
git clone --depth 1 https://github.com/kidentify/skills.git /tmp/k-id-skills
cp -R /tmp/k-id-skills/skills/* ~/.gemini/skills/
rm -rf /tmp/k-id-skills
团队共享的仓库内安装可像 Cursor 一样使用 .agents/skills/ 或 .gemini/skills/。也可运行 gemini skills install https://github.com/kidentify/skills.git（见 CLI 技能管理说明）。
其他工具和气隙环境
任何遵循 Agent Skills 规范 的 AI 代理都可以使用这些技能。Agent Skills 客户端展示 列出了 35 多种兼容工具。每个工具都记录了从哪里读取技能 — 一旦知道目录,复制配方就相同。
如果出站网络被阻止,请通过 GitHub 的绿色 "Code" 按钮下载 ZIP,将其传输到您的环境中,然后将 skills/ 目录解压到供代理使用的工具技能路径。
这些安装路径已与 Cursor、OpenAI Codex、Visual Studio Code 中的 GitHub Copilot、Gemini CLI 的官方文档对照（截至 2026 年 5 月 15 日）。若路径变更，请以各产品文档及 Agent Skills 客户端展示 为准。
如何使用技能
安装后,只需用自然语言向代理描述您的任务：
- "将 k-ID 集成到 Next.js 应用。"
- "添加带 QR、OTP 和邮件的家长同意。"
- "根据 Compliance Studio 的 Test 事件验证 webhook 处理器。"
- "在 iOS 上,在年龄门之前读取声明的年龄范围。"
路由器技能（k-id-integration）首先激活,读取请求,并交给正确的专门技能。您不需要记住技能名称。
有关技能所编码模式的更深入问题,请阅读相关概念页面：
技能背后的设计原则
- 文档优先: API 请求和响应形状来自本文档站点。技能编码的是集成模式和已知陷阱 — 而不是端点参考数据 — 因此 k-ID 这边的形状变更不会让技能脱节。
- 不变量内联: 每个
SKILL.md包含一个 "Gotchas" 部分,其中包含可防止实际出现过的 bug 的规则 — 每条都配有一行 "为什么"。 - 校准的规定性: 脆弱的操作（API 请求体形状、签名验证）被精确指定。UI 适配和框架选择由您决定。
- 最后验证: 每个功能技能以验证清单结尾,以便代理在声明完成之前确认集成确实有效。
相关
- Agent Skills 规范
- Agent Skills 客户端展示 — 35 多种兼容 AI 工具
github.com/kidentify/skills— 仓库- API 身份验证
- 测试指南