@sysvv/ai-skill 1.2.0 → 1.3.0

package/dist/core/mcp.js

@@ -0,0 +1,72 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Onde cada agent espera o arquivo de MCP */
+const MCP_TARGETS = {
+    claude: ".mcp.json",
+    codex: ".codex/mcp.json",
+    gemini: ".gemini/mcp.json",
+    copilot: ".github/copilot/mcp.json",
+};
+/** Resolve o caminho do .mcp.json dentro de /mcps/ */
+function getMcpFilePath(name) {
+    return path.resolve(__dirname, "../../mcps", `${name}.mcp.json`);
+}
+/** Carrega a definição de um MCP pelo nome */
+export async function loadMcp(name) {
+    const mcpFile = getMcpFilePath(name);
+    if (!(await fs.pathExists(mcpFile))) {
+        throw new Error(`MCP "${name}" não encontrado em mcps/${name}.mcp.json`);
+    }
+    return fs.readJson(mcpFile);
+}
+/** Extrai apenas os campos de server config (sem metadata) */
+function extractServerConfig(mcp) {
+    if (mcp.transport === "stdio") {
+        const config = { command: mcp.command };
+        if (mcp.args?.length)
+            config.args = mcp.args;
+        if (mcp.env && Object.keys(mcp.env).length)
+            config.env = mcp.env;
+        return config;
+    }
+    // sse | streamable-http
+    const config = { url: mcp.url };
+    if (mcp.headers && Object.keys(mcp.headers).length)
+        config.headers = mcp.headers;
+    if (mcp.env && Object.keys(mcp.env).length)
+        config.env = mcp.env;
+    return config;
+}
+/** Escreve o MCP no arquivo alvo do agent, fazendo merge com configs existentes */
+export async function writeMcp(agent, mcp) {
+    const targetFile = MCP_TARGETS[agent];
+    if (!targetFile)
+        throw new Error(`Agent "${agent}" não tem target de MCP configurado.`);
+    const targetPath = path.resolve(targetFile);
+    let existing = {};
+    if (await fs.pathExists(targetPath)) {
+        existing = await fs.readJson(targetPath);
+    }
+    const mcpServers = existing.mcpServers ?? {};
+    mcpServers[mcp.name] = extractServerConfig(mcp);
+    await fs.ensureDir(path.dirname(targetPath));
+    await fs.writeJson(targetPath, { ...existing, mcpServers }, { spaces: 2 });
+    return targetPath;
+}
+/** Lista todos os MCPs disponíveis */
+export async function listMcps() {
+    const mcpsDir = path.resolve(__dirname, "../../mcps");
+    if (!(await fs.pathExists(mcpsDir)))
+        return [];
+    const files = await fs.readdir(mcpsDir);
+    const results = [];
+    for (const file of files) {
+        if (file.endsWith(".mcp.json")) {
+            const mcp = await fs.readJson(path.join(mcpsDir, file));
+            results.push(mcp);
+        }
+    }
+    return results;
+}

package/dist/index.js

@@ -7,6 +7,7 @@ import { fileURLToPath } from "node:url";
 import { findSkillFiles } from "./core/registry.js";
 import { parseSkillFile } from "./core/frontmatter.js";
 import { loadSkill } from "./core/skill.js";
+import { loadMcp, writeMcp } from "./core/mcp.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // ── ANSI ────────────────────────────────────────────────────────────────
 const ANSI = {
@@ -18,6 +19,7 @@ const PINK = '\x1b[38;2;238;54;141m';
 const BLUE = '\x1b[38;2;14;93;171m';
 const RED = '\x1b[38;2;255;70;70m';
 const GREEN = '\x1b[38;2;80;200;120m';
+const YELLOW = '\x1b[38;2;255;200;50m';
 const WHITE = '\x1b[97m';
 // ── Inquirer Theme ──────────────────────────────────────────────────────
 const sysTheme = {
@@ -87,7 +89,7 @@ function showBanner() {
     console.log(indent + ANSI.dim + centerPad('│  ' + WHITE + desc + ANSI.reset + ANSI.dim + '  │', maxWidth) + ANSI.reset);
     console.log(indent + ANSI.dim + centerPad('└' + '─'.repeat(boxInner) + '┘', maxWidth) + ANSI.reset);
     console.log('');
-    console.log(indent + ANSI.dim + centerPad('npx @sysvv/ai-skill --claude | --codex | --gemini | --clear', maxWidth) + ANSI.reset);
+    console.log(indent + ANSI.dim + centerPad('npx @sysvv/ai-skill --claude | --codex | --gemini | --copilot | --clear', maxWidth) + ANSI.reset);
     console.log('');
     console.log(separator);
     console.log('');
@@ -97,6 +99,7 @@ const AGENT_DIRS = {
     claude: ".claude/skills",
     codex: ".codex/skills",
     gemini: ".gemini/skills",
+    copilot: ".github/skills",
 };
 // ── Parse args ──────────────────────────────────────────────────────────
 function parseArgs() {
@@ -109,7 +112,7 @@ function parseArgs() {
     }
     return {};
 }
-// ── Install skills for agent ────────────────────────────────────────────
+// ── Install skills + MCPs for agent ─────────────────────────────────────
 async function installSkills(agent) {
     const skillFiles = await findSkillFiles();
     const available = [];
@@ -120,7 +123,8 @@ async function installSkills(agent) {
             file,
             name: metadata.name,
             title: metadata.title ?? metadata.name,
-            description: metadata.description
+            description: metadata.description,
+            mcps: metadata.mcps ?? []
         });
     }
     if (available.length === 0) {
@@ -133,7 +137,7 @@ async function installSkills(agent) {
             name: "selected",
             message: "Escolha as skills:",
             choices: available.map((s) => ({
-                name: `${s.title} ${ANSI.dim}— ${s.description}${ANSI.reset}`,
+                name: `${s.title} ${ANSI.dim}— ${s.description}${s.mcps.length > 0 ? ` ${YELLOW}[MCP]${ANSI.reset}${ANSI.dim}` : ''}${ANSI.reset}`,
                 value: s.file
             })),
             validate: (answer) => answer.length > 0 ? true : "Selecione pelo menos uma skill.",
@@ -141,6 +145,8 @@ async function installSkills(agent) {
         }
     ]);
     const destBase = path.resolve(AGENT_DIRS[agent]);
+    const mcpsToInstall = new Set();
+    // Instala skills
     console.log('');
     for (const file of selected) {
         const skill = await loadSkill(file, agent);
@@ -148,32 +154,63 @@ async function installSkills(agent) {
         await fs.ensureDir(skillDir);
         await fs.writeFile(path.join(skillDir, "SKILL.md"), skill.renderedBody, "utf8");
         console.log(`  ${GREEN}✔${ANSI.reset} ${skill.metadata.name}`);
+        // Coleta MCPs necessários
+        for (const mcpName of skill.metadata.mcps ?? []) {
+            mcpsToInstall.add(mcpName);
+        }
+    }
+    // Instala MCPs automaticamente
+    if (mcpsToInstall.size > 0) {
+        console.log('');
+        let mcpTarget = '';
+        for (const mcpName of mcpsToInstall) {
+            try {
+                const mcp = await loadMcp(mcpName);
+                mcpTarget = await writeMcp(agent, mcp);
+                console.log(`  ${GREEN}✔${ANSI.reset} MCP ${ANSI.bold}${mcpName}${ANSI.reset} ${ANSI.dim}→ ${mcpTarget}${ANSI.reset}`);
+            }
+            catch (err) {
+                console.log(`  ${RED}✖${ANSI.reset} MCP ${mcpName}: ${err.message}`);
+            }
+        }
     }
     console.log(`\n  Skills instaladas em ${ANSI.bold}${destBase}/${ANSI.reset}\n`);
 }
-// ── Clear all skills ────────────────────────────────────────────────────
+// ── Clear all skills + MCPs ─────────────────────────────────────────────
 async function clearSkills() {
-    const existing = [];
+    const MCP_TARGETS = {
+        claude: ".mcp.json",
+        codex: ".codex/mcp.json",
+        gemini: ".gemini/mcp.json",
+        copilot: ".github/copilot/mcp.json",
+    };
+    const found = [];
     for (const [agent, dir] of Object.entries(AGENT_DIRS)) {
-        const full = path.resolve(dir);
-        if (await fs.pathExists(full)) {
-            existing.push(agent);
+        const skillsFull = path.resolve(dir);
+        const mcpFull = path.resolve(MCP_TARGETS[agent]);
+        const hasSkills = await fs.pathExists(skillsFull);
+        const hasMcp = await fs.pathExists(mcpFull);
+        if (hasSkills || hasMcp) {
+            found.push({ agent, skillsDir: skillsFull, mcpFile: mcpFull, hasSkills, hasMcp });
         }
     }
-    if (existing.length === 0) {
-        console.log("  Nenhuma pasta de skills encontrada.\n");
+    if (found.length === 0) {
+        console.log("  Nenhuma pasta de skills ou MCP encontrada.\n");
         return;
     }
-    console.log(`  ${RED}⚠${ANSI.reset}  Pastas encontradas:\n`);
-    for (const agent of existing) {
-        console.log(`     ${ANSI.dim}${path.resolve(AGENT_DIRS[agent])}${ANSI.reset}`);
+    console.log(`  ${RED}⚠${ANSI.reset}  Encontrado:\n`);
+    for (const f of found) {
+        if (f.hasSkills)
+            console.log(`     ${ANSI.dim}${f.skillsDir}${ANSI.reset}`);
+        if (f.hasMcp)
+            console.log(`     ${ANSI.dim}${f.mcpFile}${ANSI.reset}`);
     }
     console.log('');
     const { confirm } = await inquirer.prompt([
         {
             type: "confirm",
             name: "confirm",
-            message: "Tem certeza que deseja apagar TODAS as pastas de skills?",
+            message: "Tem certeza que deseja apagar TUDO (skills + MCPs)?",
             default: false,
             theme: sysTheme
         }
@@ -182,12 +219,17 @@ async function clearSkills() {
         console.log("\n  Operação cancelada.\n");
         return;
     }
-    for (const agent of existing) {
-        const full = path.resolve(AGENT_DIRS[agent]);
-        await fs.remove(full);
-        console.log(`  ${RED}✖${ANSI.reset} ${full} removida`);
+    for (const f of found) {
+        if (f.hasSkills) {
+            await fs.remove(f.skillsDir);
+            console.log(`  ${RED}✖${ANSI.reset} ${f.skillsDir}`);
+        }
+        if (f.hasMcp) {
+            await fs.remove(f.mcpFile);
+            console.log(`  ${RED}✖${ANSI.reset} ${f.mcpFile}`);
+        }
     }
-    console.log("\n  Todas as skills foram removidas.\n");
+    console.log("\n  Tudo removido.\n");
 }
 // ── Main ────────────────────────────────────────────────────────────────
 async function main() {

package/mcps/azure-devops.mcp.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "../schemas/mcp.schema.json",
+  "name": "azure-devops",
+  "description": "Integração com Azure DevOps para work items, repos e pipelines.",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "@azure-devops/mcp",
+    "sysmanagerdevops",
+    "-d", "core", "work", "work-items"
+  ],
+  "env": {
+    "AZURE_DEVOPS_PAT": "${AZURE_DEVOPS_PAT}"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sysvv/ai-skill",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Instale skills de IA direto no seu projeto. Escolha o agent, escolha as skills.",
   "type": "module",
   "bin": {
@@ -8,7 +8,9 @@
   },
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "mcps",
+    "schemas"
   ],
   "scripts": {
     "build": "tsc",

package/schemas/mcp.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sysvv.dev/schemas/mcp.schema.json",
+  "title": "MCP Server Configuration",
+  "description": "Schema para configuração de servidores MCP (Model Context Protocol). Suporta os transportes stdio, sse e streamable-http.",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Referência ao JSON Schema para validação e autocomplete."
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Identificador único do MCP. Deve ser slug (lowercase, hífens). Ex: azure-devops"
+    },
+    "description": {
+      "type": "string",
+      "description": "Descrição curta do que o MCP faz."
+    },
+    "transport": {
+      "type": "string",
+      "enum": ["stdio", "sse", "streamable-http"],
+      "description": "Tipo de transporte do MCP."
+    },
+    "command": {
+      "type": "string",
+      "description": "[stdio] Comando para iniciar o servidor MCP."
+    },
+    "args": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "[stdio] Argumentos passados ao comando."
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "[sse | streamable-http] URL do servidor MCP."
+    },
+    "headers": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "[sse | streamable-http] Headers HTTP enviados nas requisições."
+    },
+    "env": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Variáveis de ambiente. Use ${VAR} para referências dinâmicas."
+    }
+  },
+  "required": ["name", "description", "transport"],
+  "allOf": [
+    {
+      "if": {
+        "properties": { "transport": { "const": "stdio" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["command"],
+        "properties": {
+          "url": false,
+          "headers": false
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "transport": { "const": "sse" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["url"],
+        "properties": {
+          "command": false,
+          "args": false
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "transport": { "const": "streamable-http" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["url"],
+        "properties": {
+          "command": false,
+          "args": false
+        }
+      }
+    }
+  ]
+}

package/skills/azure-devops/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: azure-devops
+title: Azure DevOps
+description: gerenciar work items, repos e pipelines no Azure DevOps.
+version: 1.0.0
+providers:
+  - claude
+  - codex
+  - gemini
+mcps:
+  - azure-devops
+variables:
+  language: pt-BR
+provider_overrides:
+  claude:
+    style: "retornar bullets curtos e objetivos"
+  codex:
+    style: "retornar estrutura operacional"
+  gemini:
+    style: "retornar texto claro e organizado"
+---
+
+Você é um assistente especialista em Azure DevOps.
+
+Objetivo:
+Ajudar a gerenciar work items, repositórios e pipelines usando a integração com Azure DevOps.
+
+Capacidades:
+- Criar e atualizar work items
+- Consultar status de pipelines
+- Listar repositórios e branches
+- Buscar PRs e reviews
+
+Idioma: {{language}}
+
+Instrução específica do provider:
+{{provider_style}}