{
  "schemaVersion": "1.0",
  "item": {
    "slug": "speckit-swarm",
    "name": "Speckit Swarm",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "canonicalUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/speckit-swarm",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=speckit-swarm",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "src/complexity.ts",
      "src/concurrency.ts",
      "src/index.ts",
      "src/personas/explore.ts"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/speckit-swarm"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/speckit-swarm",
    "agentPageUrl": "https://openagent3.xyz/skills/speckit-swarm/agent",
    "manifestUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "Native implementation of oh-my-opencode-style orchestration using OpenClaw's tools."
      },
      {
        "title": "Core Components",
        "body": "Ultrawork Detector - Detects \"ulw\"/\"ultrawork\" keywords and triggers parallel execution\nAgent Personas - Specialized system prompts for different tasks\nTask Planner - Breaks complex tasks into parallel chunks\nContinuation Enforcer - Ensures tasks complete fully"
      },
      {
        "title": "File Structure",
        "body": "skills/speckit-swarm/\n├── SKILL.md                      # This file\n├── src/\n│   ├── ultrawork.ts              # Ultrawork detection & trigger\n│   ├── personas/\n│   │   ├── mod.ts               # Persona exports\n│   │   ├── sisyphus.ts          # Main orchestrator\n│   │   ├── hephaestus.ts        # Deep worker\n│   │   ├── oracle.ts            # Design/debug\n│   │   ├── librarian.ts         # Research/docs\n│   │   └── explore.ts            # Fast scout\n│   ├── planner.ts               # Task decomposition\n│   └── index.ts                 # Main entry"
      },
      {
        "title": "Manual Mode",
        "body": "# Use personas directly\nsessions_spawn task:\"...\" model:\"minimax-m2.5\" thinking:\"high\""
      },
      {
        "title": "Ultrawork Mode",
        "body": "When user includes \"ulw\" or \"ultrawork\":\n\nDetect keyword\nDecompose task into parallel chunks\nExecute with parallel_spawn\nAggregate results"
      },
      {
        "title": "Sisyphus (Main Orchestrator)",
        "body": "Model: minimax-m2.5\nThinking: high\nBehavior: Relentless execution, parallel coordination, todo tracking"
      },
      {
        "title": "Hephaestus (Deep Worker)",
        "body": "Model: minimax-m2.5\nThinking: high\nBehavior: Autonomous execution, no hand-holding, completes full scope"
      },
      {
        "title": "Oracle (Design/Debug)",
        "body": "Model: minimax-m2.5\nThinking: high\nBehavior: Architecture decisions, bug hunting, code review"
      },
      {
        "title": "Librarian (Research)",
        "body": "Model: minimax-m2.1\nThinking: medium\nBehavior: Docs lookup, code exploration, pattern finding"
      },
      {
        "title": "Explore (Scout)",
        "body": "Model: minimax-m2.5-highspeed\nThinking: low\nBehavior: Fast grep, file finding, quick analysis"
      },
      {
        "title": "1. Direct Persona Usage",
        "body": "import { PERSONAS, buildTaskPrompt } from './speckit-swarm';\n\nconst persona = PERSONAS.hephaestus;\nconst task = \"Fix the login bug in auth.ts\";\n\nsessions_spawn({\n  task: buildTaskPrompt({ task, persona: 'hephaestus' }),\n  model: persona.config.model,\n  thinking: persona.config.thinking\n});"
      },
      {
        "title": "2. Ultrawork Mode (auto-detected)",
        "body": "When user includes \"ulw\" or \"ultrawork\":\n\nimport { planTask, shouldUseUltrawork } from './speckit-swarm';\n\nconst task = \"ulw refactor the auth module\";\nif (shouldUseUltrawork(task)) {\n  const plan = planTask(task);\n  // Execute plan.chunks with parallel_spawn\n}"
      },
      {
        "title": "3. Task Decomposition",
        "body": "import { planTask } from './speckit-swarm';\n\nconst plan = planTask(\"Create a new API endpoint\");\n// plan.chunks = [{ label: 'spec', ... }, { label: 'setup', ... }, ...]"
      },
      {
        "title": "Ultrawork Handler",
        "body": "O handler detecta \"ulw\" automaticamente e prepara tarefas para parallel_spawn."
      },
      {
        "title": "Funções Exportadas",
        "body": "// Verifica se contém keyword ulw\ncontainsUltrawork(task: string): boolean\n\n// Limpa o prefixo ulw da tarefa\ncleanUltraworkTask(task: string): string\n\n// Prepara execução ultrawork\nprepareUltrawork(task: string): {\n  shouldExecute: boolean;\n  chunks: Array<{\n    label: string;\n    task: string;\n    model?: string;\n    thinking?: string;\n  }>;\n  cleanedTask: string;\n}"
      },
      {
        "title": "Exemplo de Uso",
        "body": "// Na minha resposta, quando receber mensagem com \"ulw\":\n\nconst ultrawork = prepareUltrawork(\"ulw create a new API\");\n\nif (ultrawork.shouldExecute) {\n  // Executar com parallel_spawn\n  parallel_spawn({\n    tasks: ultrawork.chunks,\n    wait: \"all\"\n  });\n}"
      },
      {
        "title": "Análise de Segurança de Concorrência",
        "body": "Antes de paralelizar, verifico se não há conflitos:\n\nTipo de TarefaEstratégiaCriar novo projeto/CLI/APIPARALLEL ✓Múltiplos arquivos novosPARALLEL ✓Refatorar móduloCAUTIOUS (verifica dependências)Corrigir bugSEQUENTIAL ✗Editar mesmo arquivoSEQUENTIAL ✗Tarefa simplesSINGLE"
      },
      {
        "title": "Fluxo de Decisão",
        "body": "Analiso complexidade - É uma tarefa grande?\nVerifico conflitos - Vai mexer no mesmo arquivo?\nDecido estratégia - parallel / sequential / single\n\nIsso evita problemas de concorrência quando múltiplos agentes tentam modificar o mesmo arquivo."
      },
      {
        "title": "Exemplo de Uso",
        "body": "// Detecção automática\nconst result = prepareParallelExecution(\"criar um novo CLI\");\n// result.shouldExecute = true (detectou complexidade)\n\nif (result.shouldExecute) {\n  parallel_spawn({\n    tasks: result.chunks,\n    wait: \"all\"\n  });\n}"
      }
    ],
    "body": "Speckit Swarm - Agent Orchestration System\nOverview\n\nNative implementation of oh-my-opencode-style orchestration using OpenClaw's tools.\n\nArchitecture\nCore Components\nUltrawork Detector - Detects \"ulw\"/\"ultrawork\" keywords and triggers parallel execution\nAgent Personas - Specialized system prompts for different tasks\nTask Planner - Breaks complex tasks into parallel chunks\nContinuation Enforcer - Ensures tasks complete fully\nFile Structure\nskills/speckit-swarm/\n├── SKILL.md                      # This file\n├── src/\n│   ├── ultrawork.ts              # Ultrawork detection & trigger\n│   ├── personas/\n│   │   ├── mod.ts               # Persona exports\n│   │   ├── sisyphus.ts          # Main orchestrator\n│   │   ├── hephaestus.ts        # Deep worker\n│   │   ├── oracle.ts            # Design/debug\n│   │   ├── librarian.ts         # Research/docs\n│   │   └── explore.ts            # Fast scout\n│   ├── planner.ts               # Task decomposition\n│   └── index.ts                 # Main entry\n\nUsage\nManual Mode\n# Use personas directly\nsessions_spawn task:\"...\" model:\"minimax-m2.5\" thinking:\"high\"\n\nUltrawork Mode\n\nWhen user includes \"ulw\" or \"ultrawork\":\n\nDetect keyword\nDecompose task into parallel chunks\nExecute with parallel_spawn\nAggregate results\nPersonas\nSisyphus (Main Orchestrator)\nModel: minimax-m2.5\nThinking: high\nBehavior: Relentless execution, parallel coordination, todo tracking\nHephaestus (Deep Worker)\nModel: minimax-m2.5\nThinking: high\nBehavior: Autonomous execution, no hand-holding, completes full scope\nOracle (Design/Debug)\nModel: minimax-m2.5\nThinking: high\nBehavior: Architecture decisions, bug hunting, code review\nLibrarian (Research)\nModel: minimax-m2.1\nThinking: medium\nBehavior: Docs lookup, code exploration, pattern finding\nExplore (Scout)\nModel: minimax-m2.5-highspeed\nThinking: low\nBehavior: Fast grep, file finding, quick analysis\nHow to Use\n1. Direct Persona Usage\nimport { PERSONAS, buildTaskPrompt } from './speckit-swarm';\n\nconst persona = PERSONAS.hephaestus;\nconst task = \"Fix the login bug in auth.ts\";\n\nsessions_spawn({\n  task: buildTaskPrompt({ task, persona: 'hephaestus' }),\n  model: persona.config.model,\n  thinking: persona.config.thinking\n});\n\n2. Ultrawork Mode (auto-detected)\n\nWhen user includes \"ulw\" or \"ultrawork\":\n\nimport { planTask, shouldUseUltrawork } from './speckit-swarm';\n\nconst task = \"ulw refactor the auth module\";\nif (shouldUseUltrawork(task)) {\n  const plan = planTask(task);\n  // Execute plan.chunks with parallel_spawn\n}\n\n3. Task Decomposition\nimport { planTask } from './speckit-swarm';\n\nconst plan = planTask(\"Create a new API endpoint\");\n// plan.chunks = [{ label: 'spec', ... }, { label: 'setup', ... }, ...]\n\nUltrawork Handler\n\nO handler detecta \"ulw\" automaticamente e prepara tarefas para parallel_spawn.\n\nFunções Exportadas\n// Verifica se contém keyword ulw\ncontainsUltrawork(task: string): boolean\n\n// Limpa o prefixo ulw da tarefa\ncleanUltraworkTask(task: string): string\n\n// Prepara execução ultrawork\nprepareUltrawork(task: string): {\n  shouldExecute: boolean;\n  chunks: Array<{\n    label: string;\n    task: string;\n    model?: string;\n    thinking?: string;\n  }>;\n  cleanedTask: string;\n}\n\nExemplo de Uso\n// Na minha resposta, quando receber mensagem com \"ulw\":\n\nconst ultrawork = prepareUltrawork(\"ulw create a new API\");\n\nif (ultrawork.shouldExecute) {\n  // Executar com parallel_spawn\n  parallel_spawn({\n    tasks: ultrawork.chunks,\n    wait: \"all\"\n  });\n}\n\nComo Eu Detecto e Executo\nAnálise de Segurança de Concorrência\n\nAntes de paralelizar, verifico se não há conflitos:\n\nTipo de Tarefa\tEstratégia\nCriar novo projeto/CLI/API\tPARALLEL ✓\nMúltiplos arquivos novos\tPARALLEL ✓\nRefatorar módulo\tCAUTIOUS (verifica dependências)\nCorrigir bug\tSEQUENTIAL ✗\nEditar mesmo arquivo\tSEQUENTIAL ✗\nTarefa simples\tSINGLE\nFluxo de Decisão\nAnaliso complexidade - É uma tarefa grande?\nVerifico conflitos - Vai mexer no mesmo arquivo?\nDecido estratégia - parallel / sequential / single\n\nIsso evita problemas de concorrência quando múltiplos agentes tentam modificar o mesmo arquivo.\n\nExemplo de Uso\n// Detecção automática\nconst result = prepareParallelExecution(\"criar um novo CLI\");\n// result.shouldExecute = true (detectou complexidade)\n\nif (result.shouldExecute) {\n  parallel_spawn({\n    tasks: result.chunks,\n    wait: \"all\"\n  });\n}"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "publisherUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "owner": "Heldinhow",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/speckit-swarm",
    "downloadUrl": "https://openagent3.xyz/downloads/speckit-swarm",
    "agentUrl": "https://openagent3.xyz/skills/speckit-swarm/agent",
    "manifestUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.md"
  }
}