我是副驾驶

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

概述

官方的腾讯 IMA 技能 (ima-skill) 公开了一个用于注释和知识库操作的强大 OpenAPI,但其安装流程是为特定的专有代理设计的,并且最近的版本已经提供了无法严格 SKILL.md 加载程序的子模块文件。 IMA Copilot 解决了这两个问题:通过 vercel-labs/skills 打开安装程序,使用单个命令将 ima-skill 安装到 Claude Code、Codex 和 OpenClaw。

架构原则(请勿违反)

该技能是 ima-skill 的包装层。包装合同是不可协商的:绝不供应商上游文件。此技能目录不包含 ima-skill 自身内容的任何副本、分支或摘录。当 ima-skill 发布新版本时,用户可以获得新版本,而不会受到此包装器的任何干扰。维修发生在运行时,而不是发货时。如果上游错误需要修补,则该技能携带如何修补的说明,而不是修补的文件。运行修复是幂等的:在上游更新后重新运行会重新检测并重新修复返回的任何内容。

这个技能有什么作用

能力 · 入口点 · 详细信息 将上游 ima-skill 安装到 3 个代理 ·scripts/install_ima_skill.sh· 见references/installation_flow.md配置 API 凭证(XDG 样式) · 下面的内联工作流程 · 请参阅references/api_key_setup.md诊断并修复已知的上游问题 ·scripts/diagnose.sh+ 下面的工作流程 · 请参阅references/known_issues.md具有优先级提升的扇出搜索·scripts/search_fanout.py· 见references/search_best_practices.md

路由

当该技能被触发时,对用户的意图进行分类并跳转到相应的能力: 用户说类似... · 转到“装ima”、“install ima-skill”、“把ima装一下”、“我想用ima” · 能力1“配ima的密钥”、“配置ima凭证”、“ima API密钥” · 能力2“ima报错”、“SKILL.md警告”、“frontmatter错误”、“ima加载失败》·能力3

功能 1:安装上游 ima-skill

安装程序从以下位置下载最新的官方版本https://app-dl.ima.qq.com/skills/,将其暂存在临时目录中,然后交给npx skills add <local-path>将其分发到 Claude Code、Codex 和 OpenClaw。 运行它: 该脚本自动检测用户计算机上安装了三个目标代理中的哪一个。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@daymade · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步 — 运行只读诊断

`diagnose.sh`从不修改任何文件。它打印一份结构化报告,每张支票一行:

02
第 2 步 — 解析报告并询问用户

对于每个`⚠️`或`❌`行,查找问题`references/known_issues.md`。该文件是以下内容的真相来源: 问题是什么(症状、根本原因) 存在哪些修复策略(`A`,`B`,`skip`) 每个策略的确切 shell 命令 每个策略涉及哪些文件

03
第 3 步 — 在接触上游文件之前请求明确同意

对具有多个修复策略的每个问题使用 AskUserQuestion。简单地描述它——用户可能不知道“YAML frontmatter”是什么意思。用用户术语描述错误对他们的影响(“加载程序默默地跳过两个文件,因此笔记搜索和知识库搜索实际上不起作用”),然后根据结果而不是机制描述每个策略。当存在多种策略时,切勿提供单一的“修复它”选项。用户的选择可能会根据技能无法观察到的因素而有所不同——例如,如果他们计划手动与上游进行比较,他们可能更喜欢策略 B(最小差异)。

04
第 4 步 — 执行所选策略

每个修复命令`references/known_issues.md`被写为:幂等 - 在应用修复后重新运行不会产生任何有害影响,并打印清晰的“已修复”消息。已备份 — 修复将原始文件复制到`/tmp/ima-copilot-backups/<timestamp>/<relative-path>`在修改任何内容之前,然后告诉用户备份位置。可逆 — 用户可以通过一次操作从备份中恢复`cp`命令显示在最后。

05
第 5 步 — 重新运行诊断以确认

修复后运行`diagnose.sh`第二次并向用户展示差异。问题应该从`⚠️`到`✅`。如果没有,请停止并向用户显示原始的之前/之后的内容,而不是默默地重试 - 这里的意外失败通常意味着上游发布了不可预见的更改。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。