SuperAPI AI 工具集

documentation-update

写作与研究

查看项目

更新于 10-15 21:51

技能介绍

用途:维护 Claude 插件市场文档的同步。它读取 marketplace.json 与插件文件,套用 Jinja2 模板,在 docs/ 目录生成四类文档:agents.md(按插件组织的代理参考,含名称、描述、模型与文件链接)、agent-skills.md(技能目录,含描述与“Use when”触发说明)、plugins.md(按分类的插件清单,含版本与组件及安装使用信息)、usage.md(入门说明、命令示例与工作流指南)。

主要能力:扫描插件代理与命令 frontmatter、提取技能元数据、组织插件分类、计算统计(插件/代理/命令/技能总数)、渲染模板并输出文件;出错时对缺失的市场文件、模板、无效插件结构和 frontmatter 解析问题给出提示。

使用方式:运行 python doc_generator.py;可用 --file agents 仅生成指定文件,--dry-run 预览不写入,--marketplace、--templates、--output 指定自定义路径。该技能可由 /claude-plugin:create 和 /claude-plugin:update 命令在市场更新后自动调用。

模板与结构:模板存于 assets/,含 agents.md.j2、agent-skills.md.j2、plugins.md.j2、usage.md.j2;模板接收 marketplace、plugins_by_category、all_agents、all_skills、all_commands、stats 等上下文变量。

适用场景:新增插件、插件组件增删、代理或技能元数据变化、需要重新生成或校验文档一致性时。

限制:需要 Python 3.8+,仅用标准库无外部依赖;需可读 .claude-plugin/marketplace.json 与插件目录,并对 docs/ 有写权限。具体收费、价格与平台支持等信息暂未提供。