sdd-toolkit 2.1.0 → 3.0.0

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."