用途:作为插件生态的健康维护中心,覆盖三类操作——Audit(按 Open Standards 做结构合规检查)、Sync(让各智能体环境与 plugins/ 保持同步并清理孤立产物)、README(为缺失文档的插件生成 README)。核心约束:同步时绝不删除项目自定义插件,只清理已被本地移除的厂商管理插件。
主要能力:结构审计按 7 个维度检查(目录布局、渐进式披露、命名规范、README 质量、CONNECTORS.md、架构定位、plugin.json 字段),并检查 SKILL.md 的 frontmatter 与正文结构;同步支持先 Dry Run 预览再应用;README 生成基于插件元数据。
使用方式:技能要求以交互式助手方式运行,先询问所需操作,再复述将要执行的任务并等待明确确认,之后才生成命令。审计运行 python3 .agents/skills/maintain-plugins/scripts/audit_structure.py;同步先运行 python3 .agents/skills/maintain-plugins/scripts/sync_with_inventory.py --dry-run,确认后再去掉 --dry-run 应用;生成 README 运行 python3 .agents/skills/maintain-plugins/scripts/generate_readmes.py --apply。依赖仅需 Python 3.8+ 标准库,安装依赖可用 pip-compile ./requirements.in 与 pip install -r ./requirements.txt。
适用场景:新增插件后验证结构、移除厂商插件后清理孤立产物、定期检查漂移或误放文件、发布前确保分发状态干净。
限制与注意:脚本中检测到 shell=True 属 CRITICAL 命令注入风险,须停止并上报;自定义插件被误清理时用 git checkout -- plugins/<name>/ 恢复;SKILL.md 超过 500 行标记为 HIGH 渐进式披露违规。厂商目录缺失时可克隆 https://github.com/richfrem/agent-plugins-skills.git 到 .vendor/agent-plugins-skills。更深入的语义与安全检查、L5 成熟度评分需调用 agent-plugin-analyzer 中的 analyze-plugin 与 l5-red-team-auditor。