mcpField
A
antv-skills-maintainer

antv-skills-maintainer

github.com/antvisAgent 工作流5161.2k 次安装5 周前更新
代码仓库

关于 antv-skills-maintainer

用于 AntV skills 仓库内部维护的技能,在每次代码变更后检查并同步技能文档与配置。它聚焦于 README.md 的技能列表和 marketplace.json 插件条目。

主要功能

  1. 01核对技能目录与 README.md
  2. 02同步技能描述与 frontmatter
  3. 03更新 marketplace.json 插件条目
  4. 04检查过期条目与 JSON 格式

适用场景

  1. 01新增技能后更新仓库索引
  2. 02修改技能描述后同步配置
  3. 03移除技能后清理过期记录

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/antvis/chart-visualization-skills --skill antv-skills-maintainer

安装后在 Claude Code 中输入/antv-skills-maintainer确认已加载。

详细介绍

AntV 技能维护器

每当在此仓库中添加或更新技能时,此技能可确保所有文档和配置文件保持同步。

重要说明

antv-skills-maintainer 技能仅供内部使用——它仅用于此仓库的迭代工作流。请勿将其添加到 README.md 的“可用技能”或 .claude-plugin/marketplace.json 中。这些文件中只能列出面向用户的技能。

何时应用

每次代码更改后都自动应用此技能,尤其是在以下情况下:

  • 在 skills/ 下新增技能目录
  • 修改现有技能的 SKILL.md(名称、描述、功能)
  • 移除或弃用某项技能

需要保持同步的内容

1. README.md —“可用技能”部分

README.md 中的 ## Available Skills 部分必须列出 skills/ 下的所有技能,并包含:

  • 合适的表情符号图标
  • 技能名称(加粗,与目录名称一致)
  • 一行描述,与技能 SKILL.md frontmatter 中的 description 字段一致
  • 一段简短说明,详细介绍技能的功能

格式:

- 🔧 **skill-name**: One-line description from SKILL.md frontmatter.

`Skill Display Name` elaboration paragraph...

步骤:

  1. 扫描 skills/ 目录,列出所有可用技能。
  2. 读取每项技能的 SKILL.md frontmatter(name、description)。
  3. 与 README.md 中当前的 ## Available Skills 部分进行比较。
  4. 为新增技能添加条目,更新已更改技能的条目,并移除已删除技能的条目。
  5. 保留该部分现有的格式风格。
2. .claude-plugin/marketplace.json — plugins 数组

.claude-plugin/marketplace.json 中的 plugins 数组必须为 skills/ 下的每项技能都包含一个条目。

条目格式:

{
  "name": "skill-name",
  "description": "Description from SKILL.md frontmatter.",
  "source": "./",
  "strict": false,
  "skills": [
    "./skills/skill-name"
  ]
}

步骤:

  1. 扫描 skills/ 目录,列出所有可用技能。
  2. 读取每项技能的 SKILL.md frontmatter(name、description)。
  3. 与 .claude-plugin/marketplace.json 中当前的 plugins 数组进行比较。
  4. 为新增技能添加条目,更新已更改技能的 description,并移除已删除技能的条目。
  5. 确保 JSON 格式正确且有效。

执行检查清单

每次更改与技能相关的代码后,按以下清单逐项检查:

  • skills/ 中的所有技能目录都已列在 README.md 的 ## Available Skills 下
  • README.md 中的所有技能描述都与对应 SKILL.md frontmatter 一致
  • skills/ 中的所有技能目录都在 .claude-plugin/marketplace.json 中有对应条目
  • marketplace.json 中的所有 description 字段都与对应 SKILL.md frontmatter 一致
  • README.md 或 marketplace.json 中均不存在已删除技能的过时条目
  • 更改后 marketplace.json 仍是有效 JSON

评论

支持 Markdown