mcpField
S
skill-adapter

skill-adapter

github.com/jeremylongshoreAgent 工作流2.9k57 次安装2 天前更新
代码仓库

关于 skill-adapter

skill-adapter 会分析仓库中的插件，并将其方法调整后用于当前任务，适合需要借鉴现有命令、Agent、技能或脚本的工作。

主要功能

  1. 01搜索插件目录
  2. 02提取插件组件中的方法
  3. 03组合互补模式
  4. 04将方法应用于任务
  5. 05报告参考来源与限制

适用场景

  1. 01将安全分析方法用于代码审查
  2. 02组合插件方法编排 API 文档
  3. 03借鉴 DevOps 插件处理部署

安装

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

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill skill-adapter

安装后在 Claude Code 中输入/skill-adapter确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
example_plugin_analysis.json
plugin_selection_rules.yaml
README.md
skill_adaptation_template.py
references/
errors.md
example-workflows.md
examples.md
how-it-works.md
README.md
scripts/
plugin_analyzer.py
README.md

详细介绍

Skill Adapter

概述

分析仓库中现有的插件，提取其功能，然后综合并应用这些已学习的模式来完成当前任务。作为通用的技能变色龙，它会发现相关插件、提取其方法和流程，并将其适配到新的请求中。

前提条件

  • 拥有对 plugins/ 目录树（community、packages、examples 类别）的读取权限
  • PATH 中可使用 grep 和 find 来发现插件
  • 熟悉插件结构：commands/*.md、agents/*.md、skills/*/SKILL.md 和 scripts/

说明

  1. 分析用户的任务，确定所需的核心能力、所属领域（安全、DevOps、测试、文档等）以及关键要求或约束（参见 ${CLAUDE_SKILL_DIR}/references/how-it-works.md）。
  2. 使用文件通配符在 plugins/community/、plugins/packages/ 和 plugins/examples/ 目录中搜索相关能力。根据 plugin.json 中的描述和关键词字段进行匹配。
  3. 对发现的每个相关插件，从其组件中提取能力：
    • 命令（commands/*.md）：阅读内容，提取方法以及输入／输出模式。
    • Agent（agents/*.md）：了解其角色、决策模式和专业领域。
    • 技能（skills/*/SKILL.md）：阅读说明，提取核心能力和工具用法。
    • 脚本（scripts/*.sh、*.py）：分析逻辑，识别可复用模式和错误处理方式。
  4. 综合提取出的模式，合并互补方法，在可能的情况下简化，并确保与当前环境兼容。
  5. 将适配后的技能应用于用户的任务，遵循已学习的方法，同时调整语法、工具和输出格式，使其符合当前上下文。
  6. 报告查阅了哪些插件、提取了哪些模式，以及如何将其适配到当前任务。

输出

结构化的适配报告，包含：

  • 已分析的插件列表，以及从每个插件提取的能力
  • 综合相关模式后形成的方法
  • 将该方法直接应用于用户任务的结果
  • 适配后技能的注意事项或限制

错误处理

错误原因解决方案
未找到匹配的插件搜索词过于狭窄，或领域未涵盖扩大搜索关键词；检查其他类别；回退到通用方法
无法访问插件目录缺少读取权限或路径不正确确认 plugins/ 目录存在且权限允许遍历
模式不兼容提取的方法与当前环境冲突优先采用最相关插件的方法；舍弃冲突部分
技能／命令文件为空插件仅包含存根，没有实际说明跳过该插件并注明其内容不完整；依靠其他来源

示例

从安全插件中学习代码分析： 任务：“分析此代码库中的问题。” 流程：发现 owasp-top-10-scanner、code-quality-enforcer 和 security-audit-agent。提取 OWASP 漏洞检查、复杂度／重复度指标和依赖项扫描模式。综合形成涵盖安全性、质量和依赖项的多层分析。将其应用于目标代码库（参见 ${CLAUDE_SKILL_DIR}/references/example-workflows.md）。

采用文档技能： 任务：“生成 API 文档。” 流程：查找 api-documenter、openapi-generator 和 readme-builder。提取代码解析、OpenAPI 规范生成和分层文档结构设计。将它们组合成端到端流水线：解析端点、生成规范、创建交互式文档并构建 README。

从 DevOps 插件中学习自动化： 任务：“自动化部署流程。” 流程：在 DevOps 类别中搜索部署、CI/CD 和 Docker 插件。提取构建-测试-部署-验证工作流、并行作业模式和服务编排方式。根据用户的具体技术栈和基础设施进行调整。

资源

  • ${CLAUDE_SKILL_DIR}/references/how-it-works.md -- 详细说明五阶段适配流程
  • ${CLAUDE_SKILL_DIR}/references/example-workflows.md -- 端到端工作流示例
  • ${CLAUDE_SKILL_DIR}/references/errors.md -- 错误处理模式

评论

支持 Markdown