# Send FIS Architecture to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/fis-architecture",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fis-architecture",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/fis_config.py",
      "scripts/fis_coordinator.py",
      "scripts/fis_lifecycle_pro.py",
      "scripts/fis_worker_toolkit.py"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### FIS Architecture 3.2 Pro

Multi-agent workflow framework for CyberMao (Main) → Worker coordination using JSON tickets and Discord Forum threads.

### When to Use This Skill

Use FIS when:

CyberMao (Main) needs to delegate complex tasks to specialized Workers
A task requires domain expertise (coding, research, writing)
You need to track task status across multiple sessions
Multi-step workflows require coordination between agents

Agent Roles:

RoleAgent IDExpertiseArchitectmainCoordination, task routing, user communicationCodingengineerPython, gprMax, algorithms, data analysisResearchresearcherTheory, literature, simulation planningWritingwriterDocumentation, LaTeX, visualization

### Discord Bot Permissions (REQUIRED)

Each agent's Discord bot must have these permissions configured in the Discord server. Without them, Thread creation and messaging will fail silently.

Required Bot Permissions:

Send Messages — reply in channels and threads
Send Messages in Threads — post inside Forum threads
Create Public Threads — create new Forum posts programmatically
Read Message History — read thread context
Embed Links — send rich embeds in reports
Attach Files — upload deliverables

How to configure:

Go to Discord Server Settings → Roles
For each bot role (CyberMao, Researcher, Engineer, Writer), enable the permissions above
Ensure each Forum channel grants these permissions to the relevant bot roles

Verify with:

{ "action": "threadCreate", "channelId": "<forum_channel_id>", "name": "Permission Test" }

If the bot lacks permissions, the discord tool will return an error.

### Tool Configuration

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

Python Environment: Requires Python 3.8+ with standard library only (no external dependencies).

### Step 1: CyberMao Delegates Task

# Generate ticket + Thread template + A2A command
python3 scripts/fis_coordinator.py delegate \\
  --agent engineer \\
  --task "Implement GPR signal filter" \\
  --forum coding

Output:

Ticket ID: TASK_YYYYMMDD_XXX_AGENT
Thread template content
sessions_send command to notify Worker

### Step 2: CyberMao Creates Forum Thread

Use the discord tool to create a Thread in the appropriate Forum channel:

{
  "action": "threadCreate",
  "channelId": "<forum_channel_id>",
  "name": "TASK_xxx: Implement GPR signal filter"
}

The response returns the new Thread ID. Then notify the Worker with the Thread ID:

python3 scripts/fis_coordinator.py notify \\
  --ticket-id TASK_xxx \\
  --thread-id <new_thread_id>

Execute the generated sessions_send command to notify the Worker.

### Step 3: Worker Executes Task

# Check ticket
python3 scripts/fis_lifecycle_pro.py list

# Update status
python3 scripts/fis_lifecycle_pro.py status \\
  --ticket-id TASK_xxx --status doing

# Optional: Spawn sub-agent for complex sub-tasks
python3 scripts/fis_worker_toolkit.py spawn \\
  --parent-ticket TASK_xxx \\
  --subtask "Analyze algorithm complexity"

Worker replies in the Forum Thread using the discord tool:

{
  "action": "threadReply",
  "channelId": "<thread_id>",
  "content": "Task received. Starting execution."
}

### Step 4: Worker Reports Completion

# Generate completion report
python3 scripts/fis_worker_toolkit.py report \\
  --parent-ticket TASK_xxx \\
  --summary "Successfully implemented GPR filter" \\
  --deliverables filter.py test_results.json

Execute the generated sessions_send command to notify CyberMao.

### Step 5: CyberMao Finalizes

# View report
python3 scripts/fis_coordinator.py report --ticket-id TASK_xxx

# Mark complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx

Archive the Thread and report to User in #daily-chat.

### Architecture

User/Linn
    ↓
CyberMao (Main) - Architect, coordinator
    ↓ sessions_send + discord threadCreate
Worker (Engineer/Researcher/Writer) - Domain experts
    ↓ (optional) sessions_spawn mode="run"
SubAgent (temporary, background) - Complex sub-tasks

Key Principles:

A2A via sessions_send — Main calls Workers, Workers report back
Ticket tracking — All tasks have JSON tickets in fis-hub/
Programmatic Thread creation — CyberMao creates Forum Threads via discord tool's threadCreate action
SubAgent background mode — sessions_spawn with mode="run", no new Thread

### fis_lifecycle_pro.py

# Create ticket
python3 scripts/fis_lifecycle_pro.py create \\
  --agent engineer --task "Description" --channel-type coding

# Update status (todo/doing/done)
python3 scripts/fis_lifecycle_pro.py status \\
  --ticket-id TASK_xxx --status doing --note "Progress update"

# Mark complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx

# List active tickets
python3 scripts/fis_lifecycle_pro.py list

# Archive old tickets
python3 scripts/fis_lifecycle_pro.py archive

### fis_coordinator.py (CyberMao only)

# Delegate and generate templates
python3 scripts/fis_coordinator.py delegate \\
  --agent researcher --task "GPR theory analysis" --forum theory

# Notify Worker after Thread is created
python3 scripts/fis_coordinator.py notify \\
  --ticket-id TASK_xxx --thread-id <discord_thread_id>

# View detailed report
python3 scripts/fis_coordinator.py report --ticket-id TASK_xxx

### fis_worker_toolkit.py (Workers only)

# Spawn sub-agent (background, no Thread)
python3 scripts/fis_worker_toolkit.py spawn \\
  --parent-ticket TASK_xxx --subtask "Complex sub-task description"

# Generate completion report
python3 scripts/fis_worker_toolkit.py report \\
  --parent-ticket TASK_xxx \\
  --summary "Completion summary" \\
  --deliverables file1.py file2.json

### Channel Mapping

CategoryForum ChannelWorkerTool FlagRESEARCH🔬-theory-derivation@Researcher--forum theoryRESEARCH📊-gpr-simulation@Researcher--forum simulationDEVELOPMENT💻-coding@Engineer--forum codingWRITING📝-drafts@Writer--forum drafts

### Error Handling

If ticket creation fails:

Check Python version: python3 --version (need 3.8+)
Verify fis-hub/ directory exists and is writable
Check disk space

If Thread creation fails:

Verify the bot has Create Public Threads permission in the target Forum channel
Check that channelId points to a Forum channel (not a regular text channel)
Confirm the bot is a member of the server with correct roles

If A2A fails:

Verify openclaw.json has agentToAgent.enabled: true
Confirm Worker agent ID is in allow list
Check Worker session is active

If sub-agent spawn fails:

Ensure mode="run" is used (not mode="session")
Verify task description is clear and specific

### Quality Standards

One Task = One Ticket — Never reuse ticket IDs
Status Updates Required — Workers must update status (TODO → DOING → DONE)
Thread Per Task — Each task gets its own Forum Thread (created via threadCreate)
A2A Confirmation — Always confirm receipt via sessions_send
Archive After Complete — Archive Thread after task completion

### Configuration

Required in ~/.openclaw/openclaw.json:

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "researcher", "engineer", "writer"]
    }
  }
}

### Quick A2A Test

# Test connectivity
sessions_send(sessionKey="engineer", message="A2A test")

### Thread Creation Test

{ "action": "threadCreate", "channelId": "<forum_channel_id>", "name": "FIS Test Thread" }

### Full Workflow Test

# 1. Create task
python3 scripts/fis_coordinator.py delegate \\
  --agent researcher --task "Test task" --forum theory

# 2. Create Forum Thread via discord tool threadCreate

# 3. Notify Worker with Thread ID
python3 scripts/fis_coordinator.py notify \\
  --ticket-id TASK_xxx --thread-id <thread_id>

# 4. Execute A2A command

# 5. Complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx

FIS 3.2 Pro | Multi-Agent Workflow Framework
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: MuseLinn
- Version: 3.3.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/fis-architecture)
- [Send to Agent page](https://openagent3.xyz/skills/fis-architecture/agent)
- [JSON manifest](https://openagent3.xyz/skills/fis-architecture/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/fis-architecture/agent.md)
- [Download page](https://openagent3.xyz/downloads/fis-architecture)