标准 Agent Skills
采用 SKILL.md 与引用文件的目录结构。安装器按官方文档适配 7 个客户端的项目与个人技能目录，由客户端按其规则发现技能。
Build with your Agent
让你的 Agent
让你的 Agent
学会 mccharts。
把组件用法、图表配置和验证流程交给 AI。
一份标准 Skill，陪你从第一张图表写到真实项目。
mccharts 3.0.0Skill 1.0.0Agent Skills 标准
Get started
下载，安装，开始对话。
解压 ZIP 后会得到 mccharts/ 文件夹。安装器需要 Node.js 18 或以上。
01选择你的使用方式
安装到 Codex 的标准技能目录；重新打开会话后，由 Agent 发现 mccharts 技能。
02在终端执行
在目标项目根目录放入解压后的 mccharts/，再执行以下命令。也可把脚本路径改成你的实际解压路径。
Terminal
node mccharts/scripts/install.mjs --agent codex --project .
先预览安装位置：在命令末尾加 --dry-run。安装完成后重新打开 Agent 会话。
npm 一行安装
mccharts-skill@1.0.0 已发布。按上面所选的 Agent 和安装范围执行以下命令，无需手动下载或解压：
npm / npx · 1.0.0
npx mccharts-skill@1.0.0 --agent codex --project .
npm 包只分发 Agent Skill。HarmonyOS 图表库 @mcui/mccharts 仍通过 OHPM 接入。
自定义目录与手动安装
用 --path 指定 skills 的父目录，安装器会在其下创建 mccharts/：
node mccharts/scripts/install.mjs --path ./my-agent/skills
也可以直接把解压后的 mccharts/ 文件夹复制到 Agent 的 skills 目录。没有自动技能发现功能时，请在对话中明确要求 Agent 读取其中的 SKILL.md，并按需打开引用文件。
03把需求交给 Agent
请使用 mccharts 技能，基于 @mcui/mccharts 3.0.0 为当前 HarmonyOS 项目接入一张可更新数据的折线图。先确认项目结构和组件 API，再给出代码，并说明已完成的验证。
它会带着这些知识工作
- 识别工程与版本，选择图表组件
- 配置 option、更新数据、接入事件
- 按支持范围处理交互与控制器
- 区分源码、构建与设备验证结果
One skill, more agents
同一份知识，不同的接入方式。
支持标准技能发现的 Agent 可自动加载；其他 Agent 可直接阅读文件使用。
通用文件读取
使用 Trae、Qoder、CodeBuddy、Cline 或自定义 Agent 时，可选择“其他 Agent / 通用”，明确要求它读取 .agents/skills/mccharts/SKILL.md。全局安装使用安装器输出的绝对路径；自动发现以客户端文档为准。
安装器提供 8 个 Agent 选项。兼容目录与标准格式不等于每个客户端都完成了端到端实测；自动发现能力取决于 Agent 版本与设置。不支持发现时，直接提供 SKILL.md 的路径即可。
Good to know
开始之前，你可能想知道。
Skill 会安装 mccharts 图表库吗？
不会。Skill 是提供给 Agent 的知识与工作指引，图表库仍按开发文档接入。安装器只复制技能文件，不代替项目构建或设备验收。
需要联网或 API Key 吗？
安装器在本地复制已经下载的文件，不要求 API Key。使用 AI Agent 本身所需的账号、模型与网络环境，由对应客户端决定。
Agent 没有发现技能怎么办？
先重新打开会话，并核对安装器输出的位置。也可以直接告诉 Agent：“请读取安装目录中的 mccharts/SKILL.md，并遵循其中的工作流程”。通用项目目录为 .agents/skills/mccharts/SKILL.md。
如何更新或移除？
相同内容可重复安装；已有不同版本时，安装器会停止覆盖。更新前将旧 mccharts/ 移到技能目录以外备份，再安装新版。移除时只删除对应的 mccharts/ 技能目录；项目代码和图表依赖分别管理。