{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fis-architecture",
    "name": "FIS Architecture",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/MuseLinn/fis-architecture",
    "canonicalUrl": "https://clawhub.ai/MuseLinn/fis-architecture",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fis-architecture",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fis-architecture",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/fis_config.py",
      "scripts/fis_coordinator.py",
      "scripts/fis_lifecycle_pro.py",
      "scripts/fis_worker_toolkit.py"
    ],
    "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/fis-architecture"
    },
    "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/fis-architecture",
    "agentPageUrl": "https://openagent3.xyz/skills/fis-architecture/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fis-architecture/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fis-architecture/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": "FIS Architecture 3.2 Pro",
        "body": "Multi-agent workflow framework for CyberMao (Main) → Worker coordination using JSON tickets and Discord Forum threads."
      },
      {
        "title": "When to Use This Skill",
        "body": "Use FIS when:\n\nCyberMao (Main) needs to delegate complex tasks to specialized Workers\nA task requires domain expertise (coding, research, writing)\nYou need to track task status across multiple sessions\nMulti-step workflows require coordination between agents\n\nAgent Roles:\n\nRoleAgent IDExpertiseArchitectmainCoordination, task routing, user communicationCodingengineerPython, gprMax, algorithms, data analysisResearchresearcherTheory, literature, simulation planningWritingwriterDocumentation, LaTeX, visualization"
      },
      {
        "title": "Discord Bot Permissions (REQUIRED)",
        "body": "Each agent's Discord bot must have these permissions configured in the Discord server. Without them, Thread creation and messaging will fail silently.\n\nRequired Bot Permissions:\n\nSend Messages — reply in channels and threads\nSend Messages in Threads — post inside Forum threads\nCreate Public Threads — create new Forum posts programmatically\nRead Message History — read thread context\nEmbed Links — send rich embeds in reports\nAttach Files — upload deliverables\n\nHow to configure:\n\nGo to Discord Server Settings → Roles\nFor each bot role (CyberMao, Researcher, Engineer, Writer), enable the permissions above\nEnsure each Forum channel grants these permissions to the relevant bot roles\n\nVerify with:\n\n{ \"action\": \"threadCreate\", \"channelId\": \"<forum_channel_id>\", \"name\": \"Permission Test\" }\n\nIf the bot lacks permissions, the discord tool will return an error."
      },
      {
        "title": "Tool Configuration",
        "body": "ToolPurposePathfis_lifecycle_pro.pyTicket lifecycle (create/status/complete/list)scripts/fis_lifecycle_pro.pyfis_coordinator.pyGenerate delegation templates (CyberMao only)scripts/fis_coordinator.pyfis_worker_toolkit.pySpawn sub-agents, generate reports (Workers only)scripts/fis_worker_toolkit.py\n\nPython Environment: Requires Python 3.8+ with standard library only (no external dependencies)."
      },
      {
        "title": "Step 1: CyberMao Delegates Task",
        "body": "# Generate ticket + Thread template + A2A command\npython3 scripts/fis_coordinator.py delegate \\\n  --agent engineer \\\n  --task \"Implement GPR signal filter\" \\\n  --forum coding\n\nOutput:\n\nTicket ID: TASK_YYYYMMDD_XXX_AGENT\nThread template content\nsessions_send command to notify Worker"
      },
      {
        "title": "Step 2: CyberMao Creates Forum Thread",
        "body": "Use the discord tool to create a Thread in the appropriate Forum channel:\n\n{\n  \"action\": \"threadCreate\",\n  \"channelId\": \"<forum_channel_id>\",\n  \"name\": \"TASK_xxx: Implement GPR signal filter\"\n}\n\nThe response returns the new Thread ID. Then notify the Worker with the Thread ID:\n\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx \\\n  --thread-id <new_thread_id>\n\nExecute the generated sessions_send command to notify the Worker."
      },
      {
        "title": "Step 3: Worker Executes Task",
        "body": "# Check ticket\npython3 scripts/fis_lifecycle_pro.py list\n\n# Update status\npython3 scripts/fis_lifecycle_pro.py status \\\n  --ticket-id TASK_xxx --status doing\n\n# Optional: Spawn sub-agent for complex sub-tasks\npython3 scripts/fis_worker_toolkit.py spawn \\\n  --parent-ticket TASK_xxx \\\n  --subtask \"Analyze algorithm complexity\"\n\nWorker replies in the Forum Thread using the discord tool:\n\n{\n  \"action\": \"threadReply\",\n  \"channelId\": \"<thread_id>\",\n  \"content\": \"Task received. Starting execution.\"\n}"
      },
      {
        "title": "Step 4: Worker Reports Completion",
        "body": "# Generate completion report\npython3 scripts/fis_worker_toolkit.py report \\\n  --parent-ticket TASK_xxx \\\n  --summary \"Successfully implemented GPR filter\" \\\n  --deliverables filter.py test_results.json\n\nExecute the generated sessions_send command to notify CyberMao."
      },
      {
        "title": "Step 5: CyberMao Finalizes",
        "body": "# View report\npython3 scripts/fis_coordinator.py report --ticket-id TASK_xxx\n\n# Mark complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\nArchive the Thread and report to User in #daily-chat."
      },
      {
        "title": "Architecture",
        "body": "User/Linn\n    ↓\nCyberMao (Main) - Architect, coordinator\n    ↓ sessions_send + discord threadCreate\nWorker (Engineer/Researcher/Writer) - Domain experts\n    ↓ (optional) sessions_spawn mode=\"run\"\nSubAgent (temporary, background) - Complex sub-tasks\n\nKey Principles:\n\nA2A via sessions_send — Main calls Workers, Workers report back\nTicket tracking — All tasks have JSON tickets in fis-hub/\nProgrammatic Thread creation — CyberMao creates Forum Threads via discord tool's threadCreate action\nSubAgent background mode — sessions_spawn with mode=\"run\", no new Thread"
      },
      {
        "title": "fis_lifecycle_pro.py",
        "body": "# Create ticket\npython3 scripts/fis_lifecycle_pro.py create \\\n  --agent engineer --task \"Description\" --channel-type coding\n\n# Update status (todo/doing/done)\npython3 scripts/fis_lifecycle_pro.py status \\\n  --ticket-id TASK_xxx --status doing --note \"Progress update\"\n\n# Mark complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\n# List active tickets\npython3 scripts/fis_lifecycle_pro.py list\n\n# Archive old tickets\npython3 scripts/fis_lifecycle_pro.py archive"
      },
      {
        "title": "fis_coordinator.py (CyberMao only)",
        "body": "# Delegate and generate templates\npython3 scripts/fis_coordinator.py delegate \\\n  --agent researcher --task \"GPR theory analysis\" --forum theory\n\n# Notify Worker after Thread is created\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx --thread-id <discord_thread_id>\n\n# View detailed report\npython3 scripts/fis_coordinator.py report --ticket-id TASK_xxx"
      },
      {
        "title": "fis_worker_toolkit.py (Workers only)",
        "body": "# Spawn sub-agent (background, no Thread)\npython3 scripts/fis_worker_toolkit.py spawn \\\n  --parent-ticket TASK_xxx --subtask \"Complex sub-task description\"\n\n# Generate completion report\npython3 scripts/fis_worker_toolkit.py report \\\n  --parent-ticket TASK_xxx \\\n  --summary \"Completion summary\" \\\n  --deliverables file1.py file2.json"
      },
      {
        "title": "Channel Mapping",
        "body": "CategoryForum ChannelWorkerTool FlagRESEARCH🔬-theory-derivation@Researcher--forum theoryRESEARCH📊-gpr-simulation@Researcher--forum simulationDEVELOPMENT💻-coding@Engineer--forum codingWRITING📝-drafts@Writer--forum drafts"
      },
      {
        "title": "Error Handling",
        "body": "If ticket creation fails:\n\nCheck Python version: python3 --version (need 3.8+)\nVerify fis-hub/ directory exists and is writable\nCheck disk space\n\nIf Thread creation fails:\n\nVerify the bot has Create Public Threads permission in the target Forum channel\nCheck that channelId points to a Forum channel (not a regular text channel)\nConfirm the bot is a member of the server with correct roles\n\nIf A2A fails:\n\nVerify openclaw.json has agentToAgent.enabled: true\nConfirm Worker agent ID is in allow list\nCheck Worker session is active\n\nIf sub-agent spawn fails:\n\nEnsure mode=\"run\" is used (not mode=\"session\")\nVerify task description is clear and specific"
      },
      {
        "title": "Quality Standards",
        "body": "One Task = One Ticket — Never reuse ticket IDs\nStatus Updates Required — Workers must update status (TODO → DOING → DONE)\nThread Per Task — Each task gets its own Forum Thread (created via threadCreate)\nA2A Confirmation — Always confirm receipt via sessions_send\nArchive After Complete — Archive Thread after task completion"
      },
      {
        "title": "Configuration",
        "body": "Required in ~/.openclaw/openclaw.json:\n\n{\n  \"tools\": {\n    \"agentToAgent\": {\n      \"enabled\": true,\n      \"allow\": [\"main\", \"researcher\", \"engineer\", \"writer\"]\n    }\n  }\n}"
      },
      {
        "title": "Quick A2A Test",
        "body": "# Test connectivity\nsessions_send(sessionKey=\"engineer\", message=\"A2A test\")"
      },
      {
        "title": "Thread Creation Test",
        "body": "{ \"action\": \"threadCreate\", \"channelId\": \"<forum_channel_id>\", \"name\": \"FIS Test Thread\" }"
      },
      {
        "title": "Full Workflow Test",
        "body": "# 1. Create task\npython3 scripts/fis_coordinator.py delegate \\\n  --agent researcher --task \"Test task\" --forum theory\n\n# 2. Create Forum Thread via discord tool threadCreate\n\n# 3. Notify Worker with Thread ID\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx --thread-id <thread_id>\n\n# 4. Execute A2A command\n\n# 5. Complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\nFIS 3.2 Pro | Multi-Agent Workflow Framework"
      }
    ],
    "body": "FIS Architecture 3.2 Pro\n\nMulti-agent workflow framework for CyberMao (Main) → Worker coordination using JSON tickets and Discord Forum threads.\n\nWhen to Use This Skill\n\nUse FIS when:\n\nCyberMao (Main) needs to delegate complex tasks to specialized Workers\nA task requires domain expertise (coding, research, writing)\nYou need to track task status across multiple sessions\nMulti-step workflows require coordination between agents\n\nAgent Roles:\n\nRole\tAgent ID\tExpertise\nArchitect\tmain\tCoordination, task routing, user communication\nCoding\tengineer\tPython, gprMax, algorithms, data analysis\nResearch\tresearcher\tTheory, literature, simulation planning\nWriting\twriter\tDocumentation, LaTeX, visualization\nDiscord Bot Permissions (REQUIRED)\n\nEach agent's Discord bot must have these permissions configured in the Discord server. Without them, Thread creation and messaging will fail silently.\n\nRequired Bot Permissions:\n\nSend Messages — reply in channels and threads\nSend Messages in Threads — post inside Forum threads\nCreate Public Threads — create new Forum posts programmatically\nRead Message History — read thread context\nEmbed Links — send rich embeds in reports\nAttach Files — upload deliverables\n\nHow to configure:\n\nGo to Discord Server Settings → Roles\nFor each bot role (CyberMao, Researcher, Engineer, Writer), enable the permissions above\nEnsure each Forum channel grants these permissions to the relevant bot roles\n\nVerify with:\n\n{ \"action\": \"threadCreate\", \"channelId\": \"<forum_channel_id>\", \"name\": \"Permission Test\" }\n\n\nIf the bot lacks permissions, the discord tool will return an error.\n\nTool Configuration\nTool\tPurpose\tPath\nfis_lifecycle_pro.py\tTicket lifecycle (create/status/complete/list)\tscripts/fis_lifecycle_pro.py\nfis_coordinator.py\tGenerate delegation templates (CyberMao only)\tscripts/fis_coordinator.py\nfis_worker_toolkit.py\tSpawn sub-agents, generate reports (Workers only)\tscripts/fis_worker_toolkit.py\n\nPython Environment: Requires Python 3.8+ with standard library only (no external dependencies).\n\nCore Workflow\nStep 1: CyberMao Delegates Task\n# Generate ticket + Thread template + A2A command\npython3 scripts/fis_coordinator.py delegate \\\n  --agent engineer \\\n  --task \"Implement GPR signal filter\" \\\n  --forum coding\n\n\nOutput:\n\nTicket ID: TASK_YYYYMMDD_XXX_AGENT\nThread template content\nsessions_send command to notify Worker\nStep 2: CyberMao Creates Forum Thread\n\nUse the discord tool to create a Thread in the appropriate Forum channel:\n\n{\n  \"action\": \"threadCreate\",\n  \"channelId\": \"<forum_channel_id>\",\n  \"name\": \"TASK_xxx: Implement GPR signal filter\"\n}\n\n\nThe response returns the new Thread ID. Then notify the Worker with the Thread ID:\n\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx \\\n  --thread-id <new_thread_id>\n\n\nExecute the generated sessions_send command to notify the Worker.\n\nStep 3: Worker Executes Task\n# Check ticket\npython3 scripts/fis_lifecycle_pro.py list\n\n# Update status\npython3 scripts/fis_lifecycle_pro.py status \\\n  --ticket-id TASK_xxx --status doing\n\n# Optional: Spawn sub-agent for complex sub-tasks\npython3 scripts/fis_worker_toolkit.py spawn \\\n  --parent-ticket TASK_xxx \\\n  --subtask \"Analyze algorithm complexity\"\n\n\nWorker replies in the Forum Thread using the discord tool:\n\n{\n  \"action\": \"threadReply\",\n  \"channelId\": \"<thread_id>\",\n  \"content\": \"Task received. Starting execution.\"\n}\n\nStep 4: Worker Reports Completion\n# Generate completion report\npython3 scripts/fis_worker_toolkit.py report \\\n  --parent-ticket TASK_xxx \\\n  --summary \"Successfully implemented GPR filter\" \\\n  --deliverables filter.py test_results.json\n\n\nExecute the generated sessions_send command to notify CyberMao.\n\nStep 5: CyberMao Finalizes\n# View report\npython3 scripts/fis_coordinator.py report --ticket-id TASK_xxx\n\n# Mark complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\n\nArchive the Thread and report to User in #daily-chat.\n\nArchitecture\nUser/Linn\n    ↓\nCyberMao (Main) - Architect, coordinator\n    ↓ sessions_send + discord threadCreate\nWorker (Engineer/Researcher/Writer) - Domain experts\n    ↓ (optional) sessions_spawn mode=\"run\"\nSubAgent (temporary, background) - Complex sub-tasks\n\n\nKey Principles:\n\nA2A via sessions_send — Main calls Workers, Workers report back\nTicket tracking — All tasks have JSON tickets in fis-hub/\nProgrammatic Thread creation — CyberMao creates Forum Threads via discord tool's threadCreate action\nSubAgent background mode — sessions_spawn with mode=\"run\", no new Thread\nCommands Reference\nfis_lifecycle_pro.py\n# Create ticket\npython3 scripts/fis_lifecycle_pro.py create \\\n  --agent engineer --task \"Description\" --channel-type coding\n\n# Update status (todo/doing/done)\npython3 scripts/fis_lifecycle_pro.py status \\\n  --ticket-id TASK_xxx --status doing --note \"Progress update\"\n\n# Mark complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\n# List active tickets\npython3 scripts/fis_lifecycle_pro.py list\n\n# Archive old tickets\npython3 scripts/fis_lifecycle_pro.py archive\n\nfis_coordinator.py (CyberMao only)\n# Delegate and generate templates\npython3 scripts/fis_coordinator.py delegate \\\n  --agent researcher --task \"GPR theory analysis\" --forum theory\n\n# Notify Worker after Thread is created\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx --thread-id <discord_thread_id>\n\n# View detailed report\npython3 scripts/fis_coordinator.py report --ticket-id TASK_xxx\n\nfis_worker_toolkit.py (Workers only)\n# Spawn sub-agent (background, no Thread)\npython3 scripts/fis_worker_toolkit.py spawn \\\n  --parent-ticket TASK_xxx --subtask \"Complex sub-task description\"\n\n# Generate completion report\npython3 scripts/fis_worker_toolkit.py report \\\n  --parent-ticket TASK_xxx \\\n  --summary \"Completion summary\" \\\n  --deliverables file1.py file2.json\n\nChannel Mapping\nCategory\tForum Channel\tWorker\tTool Flag\nRESEARCH\t🔬-theory-derivation\t@Researcher\t--forum theory\nRESEARCH\t📊-gpr-simulation\t@Researcher\t--forum simulation\nDEVELOPMENT\t💻-coding\t@Engineer\t--forum coding\nWRITING\t📝-drafts\t@Writer\t--forum drafts\nError Handling\n\nIf ticket creation fails:\n\nCheck Python version: python3 --version (need 3.8+)\nVerify fis-hub/ directory exists and is writable\nCheck disk space\n\nIf Thread creation fails:\n\nVerify the bot has Create Public Threads permission in the target Forum channel\nCheck that channelId points to a Forum channel (not a regular text channel)\nConfirm the bot is a member of the server with correct roles\n\nIf A2A fails:\n\nVerify openclaw.json has agentToAgent.enabled: true\nConfirm Worker agent ID is in allow list\nCheck Worker session is active\n\nIf sub-agent spawn fails:\n\nEnsure mode=\"run\" is used (not mode=\"session\")\nVerify task description is clear and specific\nQuality Standards\nOne Task = One Ticket — Never reuse ticket IDs\nStatus Updates Required — Workers must update status (TODO → DOING → DONE)\nThread Per Task — Each task gets its own Forum Thread (created via threadCreate)\nA2A Confirmation — Always confirm receipt via sessions_send\nArchive After Complete — Archive Thread after task completion\nConfiguration\n\nRequired in ~/.openclaw/openclaw.json:\n\n{\n  \"tools\": {\n    \"agentToAgent\": {\n      \"enabled\": true,\n      \"allow\": [\"main\", \"researcher\", \"engineer\", \"writer\"]\n    }\n  }\n}\n\nTesting\nQuick A2A Test\n# Test connectivity\nsessions_send(sessionKey=\"engineer\", message=\"A2A test\")\n\nThread Creation Test\n{ \"action\": \"threadCreate\", \"channelId\": \"<forum_channel_id>\", \"name\": \"FIS Test Thread\" }\n\nFull Workflow Test\n# 1. Create task\npython3 scripts/fis_coordinator.py delegate \\\n  --agent researcher --task \"Test task\" --forum theory\n\n# 2. Create Forum Thread via discord tool threadCreate\n\n# 3. Notify Worker with Thread ID\npython3 scripts/fis_coordinator.py notify \\\n  --ticket-id TASK_xxx --thread-id <thread_id>\n\n# 4. Execute A2A command\n\n# 5. Complete\npython3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx\n\n\nFIS 3.2 Pro | Multi-Agent Workflow Framework"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/MuseLinn/fis-architecture",
    "publisherUrl": "https://clawhub.ai/MuseLinn/fis-architecture",
    "owner": "MuseLinn",
    "version": "3.3.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fis-architecture",
    "downloadUrl": "https://openagent3.xyz/downloads/fis-architecture",
    "agentUrl": "https://openagent3.xyz/skills/fis-architecture/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fis-architecture/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fis-architecture/agent.md"
  }
}