关于 antv-skills-maintainer
用于 AntV skills 仓库内部维护的技能,在每次代码变更后检查并同步技能文档与配置。它聚焦于 README.md 的技能列表和 marketplace.json 插件条目。
主要功能
- 01核对技能目录与 README.md
- 02同步技能描述与 frontmatter
- 03更新 marketplace.json 插件条目
- 04检查过期条目与 JSON 格式
适用场景
- 01新增技能后更新仓库索引
- 02修改技能描述后同步配置
- 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.mdfrontmatter 中的description字段一致 - 一段简短说明,详细介绍技能的功能
格式:
- 🔧 **skill-name**: One-line description from SKILL.md frontmatter.
`Skill Display Name` elaboration paragraph...
步骤:
- 扫描
skills/目录,列出所有可用技能。 - 读取每项技能的
SKILL.mdfrontmatter(name、description)。 - 与
README.md中当前的## Available Skills部分进行比较。 - 为新增技能添加条目,更新已更改技能的条目,并移除已删除技能的条目。
- 保留该部分现有的格式风格。
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"
]
}
步骤:
- 扫描
skills/目录,列出所有可用技能。 - 读取每项技能的
SKILL.mdfrontmatter(name、description)。 - 与
.claude-plugin/marketplace.json中当前的plugins数组进行比较。 - 为新增技能添加条目,更新已更改技能的
description,并移除已删除技能的条目。 - 确保 JSON 格式正确且有效。
执行检查清单
每次更改与技能相关的代码后,按以下清单逐项检查:
-
skills/中的所有技能目录都已列在README.md的## Available Skills下 -
README.md中的所有技能描述都与对应SKILL.mdfrontmatter 一致 -
skills/中的所有技能目录都在.claude-plugin/marketplace.json中有对应条目 -
marketplace.json中的所有description字段都与对应SKILL.mdfrontmatter 一致 -
README.md或marketplace.json中均不存在已删除技能的过时条目 - 更改后
marketplace.json仍是有效 JSON
评论
支持 Markdown