sdd-toolkit 2.1.0 → 3.1.0

package/src/lib/handlers/cursor.js

@@ -0,0 +1,34 @@
+const fsp = require('fs/promises');
+const path = require('path');
+const { toCursorMDC, toCursorSkill } = require('../transformers');
+
+/**
+ * Handles installation for Cursor
+ * @param {Array} agents - List of agents to install
+ * @param {Object} options - Installation options
+ */
+async function install(agents, options) {
+    const commandsDir = path.join(process.cwd(), '.cursor', 'commands');
+    const skillsDir = path.join(process.cwd(), '.cursor', 'skills');
+    
+    await fsp.mkdir(commandsDir, { recursive: true });
+    await fsp.mkdir(skillsDir, { recursive: true });
+
+    await Promise.all(
+        agents.map(async (agent) => {
+            const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+            
+            // Generate Commands (.mdc)
+            const mdc = toCursorMDC(agent, options);
+            await fsp.writeFile(path.join(commandsDir, `${agent.slug}.mdc`), mdc);
+            
+            // Generate Skills (SKILL.md)
+            const skillDir = path.join(skillsDir, skillName);
+            await fsp.mkdir(skillDir, { recursive: true });
+            const skill = toCursorSkill(agent, options);
+            await fsp.writeFile(path.join(skillDir, 'SKILL.md'), skill);
+        })
+    );
+}
+
+module.exports = { install };

package/src/lib/handlers/gemini.js

@@ -0,0 +1,34 @@
+const fsp = require('fs/promises');
+const path = require('path');
+const { toGeminiTOML, toGeminiSkill } = require('../transformers');
+
+/**
+ * Handles installation for Gemini
+ * @param {Array} agents - List of agents to install
+ * @param {Object} options - Installation options
+ */
+async function install(agents, options) {
+    const commandsDir = path.join(process.cwd(), '.gemini', 'commands', 'dev');
+    const skillsDir = path.join(process.cwd(), '.gemini', 'skills');
+    
+    await fsp.mkdir(commandsDir, { recursive: true });
+    await fsp.mkdir(skillsDir, { recursive: true });
+
+    await Promise.all(
+        agents.map(async (agent) => {
+            // Generate Command (TOML)
+            const toml = toGeminiTOML(agent, options);
+            const fileName = `${agent.originalName}.toml`;
+            await fsp.writeFile(path.join(commandsDir, fileName), toml);
+
+            // Generate Skill
+            const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+            const agentSkillDir = path.join(skillsDir, skillName);
+            await fsp.mkdir(agentSkillDir, { recursive: true });
+            const skillContent = toGeminiSkill(agent, options);
+            await fsp.writeFile(path.join(agentSkillDir, 'SKILL.md'), skillContent);
+        })
+    );
+}
+
+module.exports = { install };

package/src/lib/handlers/index.js

@@ -0,0 +1,17 @@
+const gemini = require('./gemini');
+const roo = require('./roo');
+const claude = require('./claude');
+const cursor = require('./cursor');
+const kilo = require('./kilo');
+const opencode = require('./opencode');
+const antigravity = require('./antigravity');
+
+module.exports = {
+    gemini,
+    roo,
+    claude,
+    cursor,
+    kilo,
+    opencode,
+    antigravity
+};

package/src/lib/handlers/kilo.js

@@ -0,0 +1,34 @@
+const fsp = require('fs/promises');
+const path = require('path');
+const { toKiloMarkdown, toKiloSkill } = require('../transformers');
+
+/**
+ * Handles installation for Kilo Code
+ * @param {Array} agents - List of agents to install
+ * @param {Object} options - Installation options
+ */
+async function install(agents, options) {
+    const workflowsDir = path.join(process.cwd(), '.kilocode', 'workflows');
+    const skillsDir = path.join(process.cwd(), '.kilocode', 'skills');
+    
+    await fsp.mkdir(workflowsDir, { recursive: true });
+    await fsp.mkdir(skillsDir, { recursive: true });
+
+    await Promise.all(
+        agents.map(async (agent) => {
+            const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+            // Generate Workflow
+            const workflow = toKiloMarkdown(agent, options);
+            await fsp.writeFile(path.join(workflowsDir, `${agent.slug}.md`), workflow);
+
+            // Generate Skill
+            const agentSkillDir = path.join(skillsDir, skillName);
+            await fsp.mkdir(agentSkillDir, { recursive: true });
+            const skill = toKiloSkill(agent, options);
+            await fsp.writeFile(path.join(agentSkillDir, 'SKILL.md'), skill);
+        })
+    );
+}
+
+module.exports = { install };

package/src/lib/handlers/opencode.js

@@ -0,0 +1,36 @@
+const fsp = require('fs/promises');
+const path = require('path');
+const { toOpenCodeSkill, toOpenCodeSubagent } = require('../transformers');
+
+/**
+ * Handles installation for OpenCode
+ * @param {Array} agents - List of agents to install
+ * @param {Object} options - Installation options
+ */
+async function install(agents, options) {
+    const skillsDir = path.join(process.cwd(), '.opencode', 'skills');
+    const agentsDir = path.join(process.cwd(), '.opencode', 'agents');
+    
+    // Ensure base directories exist
+    await fsp.mkdir(skillsDir, { recursive: true });
+    await fsp.mkdir(agentsDir, { recursive: true });
+
+    await Promise.all(
+        agents.map(async (agent) => {
+             // Ensure compatibility with naming rules (lowercase, alphanumeric, single hyphens)
+             const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+             
+             // Generate Skill: .opencode/skills/[agent-slug]/SKILL.md
+             const agentSkillDir = path.join(skillsDir, skillName);
+             await fsp.mkdir(agentSkillDir, { recursive: true });
+             const skillContent = toOpenCodeSkill(agent, options);
+             await fsp.writeFile(path.join(agentSkillDir, 'SKILL.md'), skillContent);
+
+             // Generate Subagent: .opencode/agents/[agent-slug].md
+             const subagentContent = toOpenCodeSubagent(agent, options);
+             await fsp.writeFile(path.join(agentsDir, `${skillName}.md`), subagentContent);
+        })
+    );
+}
+
+module.exports = { install };

package/src/lib/handlers/roo.js

@@ -0,0 +1,27 @@
+const fsp = require('fs/promises');
+const path = require('path');
+const { toRooSkill } = require('../transformers');
+
+/**
+ * Handles installation for Roo Code
+ * @param {Array} agents - List of agents to install
+ * @param {Object} options - Installation options
+ */
+async function install(agents, options) {
+    const skillsDir = path.join(process.cwd(), '.roo', 'skills');
+    await fsp.mkdir(skillsDir, { recursive: true });
+
+    await Promise.all(
+        agents.map(async (agent) => {
+            const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+            // Generate Skill: .roo/skills/[agent-slug]/SKILL.md
+            const agentSkillDir = path.join(skillsDir, skillName);
+            await fsp.mkdir(agentSkillDir, { recursive: true });
+            const skillContent = toRooSkill(agent, options);
+            await fsp.writeFile(path.join(agentSkillDir, 'SKILL.md'), skillContent);
+        })
+    );
+}
+
+module.exports = { install };

package/src/lib/transformers.js

@@ -66,6 +66,32 @@ function toGeminiTOML(agent, options = {}) {
     return toml;
 }
 
+/**
+ * Converte para Gemini CLI Skill (.gemini/skills/<name>/SKILL.md)
+ * Ref: https://github.com/google-gemini/gemini-cli
+ */
+function toGeminiSkill(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    // Generate trigger description for Gemini to know when to activate
+    const triggerHints = `Use when working on ${agent.role.toLowerCase()} tasks.`;
+
+    return `---
+name: ${agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')}
+description: ${agent.description || agent.role}. ${triggerHints}
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
 /**
  * Converte para configuração de Custom Mode do Roo Code / Cline (JSON)
  */
@@ -89,6 +115,34 @@ function toRooConfig(agent, slug, options = {}) {
     };
 }
 
+/**
+ * Converte para Roo Code Skill (.roo/skills/<nome>/SKILL.md)
+ * Ref: https://docs.roocode.com/features/skills
+ */
+function toRooSkill(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+    const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+    return `---
+name: ${skillName}
+description: ${agent.description || agent.role}. Use when working on ${agent.role.toLowerCase()} tasks.
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## When to Use
+- Use this skill when working on ${agent.role.toLowerCase()} tasks
+- This skill is helpful for ${agent.description || agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
 /**
  * Converte para Markdown do Kilo Code
  */
@@ -113,6 +167,30 @@ function toKiloMarkdown(agent, options = {}) {
     return parts.join('\n');
 }
 
+/**
+ * Converte para Kilo Code Skill (.kilocode/skills/<name>/SKILL.md)
+ * Ref: https://kilo.ai/docs/skills
+ */
+function toKiloSkill(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+    const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+    return `---
+name: ${skillName}
+description: ${agent.description || agent.role}. Use when working on ${agent.role.toLowerCase()} tasks.
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
 /**
  * Converte para Instruções do GitHub Copilot (.github/copilot-instructions.md)
  */
@@ -174,6 +252,34 @@ ${allRules.length > 0 ? '## Rules\n' + allRules.map(r => `- ${r}`).join('\n') :
 `;
 }
 
+/**
+ * Converte para Cursor Skill (.cursor/skills/<nome>/SKILL.md)
+ * Formato oficial: https://cursor.com/docs/context/skills
+ */
+function toCursorSkill(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+    const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+    return `---
+name: ${skillName}
+description: ${agent.description || agent.role}. Use when working on ${agent.role.toLowerCase()} tasks.
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## When to Use
+- Use this skill when working on ${agent.role.toLowerCase()} tasks
+- This skill is helpful for ${agent.description || agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\\n' + allRules.map(r => `- ${r}`).join('\\n') : ''}
+`;
+}
+
 /**
  * Converte para Windsurf Workflow (.windsurf/workflows/*.md)
  * Cascade reconhece esses arquivos como comandos de workflow
@@ -216,6 +322,60 @@ ${allRules.length > 0 ? '## Rules\n' + allRules.map(r => `- ${r}`).join('\n') :
 `;
 }
 
+/**
+ * Converte para Claude Code Skill (.claude/skills/<name>/SKILL.md)
+ * Ref: https://docs.anthropic.com/en/docs/claude-code/skills
+ */
+function toClaudeSkill(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+    const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+    return `---
+name: ${skillName}
+description: ${agent.description || agent.role}. Use when working on ${agent.role.toLowerCase()} tasks.
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Claude Code Subagent (.claude/agents/<name>.md)
+ * Ref: https://docs.anthropic.com/en/docs/claude-code/sub-agents
+ */
+function toClaudeSubagent(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    // Determine tool permissions based on agent role
+    const roleLower = (agent.slug || '').toLowerCase();
+    const isReadOnly = roleLower.includes('review') || roleLower.includes('security') || roleLower.includes('qa');
+    const tools = isReadOnly ? 'Read, Glob, Grep' : 'Read, Edit, Write, Bash';
+
+    return `---
+name: ${agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')}
+description: ${agent.description || agent.role}
+tools: ${tools}
+model: sonnet
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
 /**
  * Converte para System Prompt Puro (OpenAI/Claude/Web)
  */
@@ -304,15 +464,79 @@ ${allRules.length > 0 ? '## Constraints\n' + allRules.map(r => `- ${r}`).join('\
 
 
 /**
- * Converte para Antigravity Skill (SKILL.md)
+ * Converte para Antigravity Skill (.agent/skills/<nome>/SKILL.md)
+ * Ref: https://antigravity.google/docs/skills
  */
 function toAntigravitySkill(agent, options = {}) {
     const languageRule = getLanguageRule(options.locale);
     const allRules = [languageRule, ...(agent.rules || [])];
+    const skillName = agent.slug.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+    return `---
+name: ${skillName}
+description: ${agent.description || agent.role}. Use when working on ${agent.role.toLowerCase()} tasks.
+---
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## When to Use
+- Use this skill when working on ${agent.role.toLowerCase()} tasks
+- This skill is helpful for ${agent.description || agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Antigravity Workflow (.agent/workflows/<nome>.md)
+ * Workflows são invocáveis via /workflow-name
+ * Ref: https://antigravity.google/docs/rules-workflows
+ */
+function toAntigravityWorkflow(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `# ${agent.name} ${agent.emoji}
+
+${agent.description || agent.role}
+
+## Steps
+
+1. **Understand the Context**: Review the current codebase and requirements
+2. **Apply Role**: Act as ${agent.role}
+3. **Follow Instructions**: Execute according to the guidelines below
+
+## Instructions
+
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para OpenCode Subagent (.opencode/agents/*.md)
+ * Ref: https://opencode.ai/docs/agents
+ */
+function toOpenCodeSubagent(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    // Determine tool permissions based on agent role
+    const roleLower = (agent.slug || '').toLowerCase();
+    const isReadOnly = roleLower.includes('review') || roleLower.includes('security') || roleLower.includes('qa');
 
     return `---
-name: ${agent.name}
 description: ${agent.description || agent.role}
+mode: subagent
+tools:
+  write: ${!isReadOnly}
+  edit: ${!isReadOnly}
+  bash: ${!isReadOnly}
 ---
 # ${agent.name} ${agent.emoji}
 
@@ -327,14 +551,22 @@ ${allRules.length > 0 ? '## Rules & Guidelines\n' + allRules.map(r => `- ${r}`).
 
 module.exports = {
     toGeminiTOML,
+    toGeminiSkill,
     toRooConfig,
+    toRooSkill,
     toKiloMarkdown,
+    toKiloSkill,
     toCopilotInstructions,
     toCursorMDC,
+    toCursorSkill,
     toWindsurfRules,
     toClaudeCommand,
+    toClaudeSkill,
+    toClaudeSubagent,
     toPlainSystemPrompt,
     toOpenCodeSkill,
+    toOpenCodeSubagent,
     toTraeRules,
-    toAntigravitySkill
+    toAntigravitySkill,
+    toAntigravityWorkflow
 };

package/definitions/sdd.yaml

@@ -1,29 +0,0 @@
-name: SDD Helper
-role: Agent Access Gateway
-emoji: 🔑
-systemPrompt: |
-  # Identity
-  You are the **SDD Helper** 🔑, providing quick access to all installed agents.
-
-  # Core Instructions
-  You are the central hub for accessing SDD Toolkit agents. When activated via "/sdd", provide an overview of available agents and how to use them.
-
-  ## Available Agents
-  - **/sdd.project**: Project Architect 🏛️ - Defines project scope and vision.
-  - **/sdd.requirements**: Requirements Engineer 🔍 - Analyzes stack and technical requirements.
-  - **/sdd.feature**: Feature Manager ✨ - Manages features, milestones, and tasks.
-  - **/sdd.coder**: Coder 💻 - Implements code following SOLID principles.
-  - **/sdd.review**: QA Engineer 🔍 - Reviews and validates code quality.
-  - **/sdd.log**: Release Manager 📦 - Consolidates logs and manages changelog.
-
-  ## Usage
-  - Type "/sdd" to see this help.
-  - Type "/<agent>" to activate a specific agent (e.g., "/project" for Project Architect).
-  - For workflows: Use "/flow:debug", "/flow:tdd", "/flow:refactor", etc., within the coding context.
-
-  Always respond in the user's language. If no specific command is given, display this help.
-
-rules:
-  - "Respond in the user's language (English by default)."
-  - "Provide concise, actionable guidance."
-  - "Do not execute code or make changes; only guide access."