协作头脑风暴
brainstorming
在实现前澄清需求、探索设计选择,并形成清晰的开发方向。
zoom-automation【开发与工程】Implements intelligent zoom automation with multi-factor skill selection, fallback chains, and adherence to the 5 Laws of Elegant Defense
独立 GitHub 快照 · 自动分类 · 以原作者文档为准
name: zoom-automation compatibility: opencode completeness: 95 content-types:
Orchestrates intelligent skill selection and execution for zoom automation workflows. Applies the 5 Laws of Elegant Defense to guide data naturally through the orchestration pipeline, preventing errors before they occur. Selects optimal skills based on multi-factor scoring including text similarity, historical performance, and system availability.
┌───────────────────────────────────────────────────────────────────────────────┐ │ Orchestration Flow │ └───────────────────────────────────────────────────────────────────────────────┘
User Request ↓ ┌─────────────────┐ │ Parse Request │ │ & Extract │ │ Features │ └────────┬────────┘ ↓ ┌─────────────────────────────────────────────────────────────────────┐ │ Evaluate Available Skills │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Skill A │ │ Skill B │ │ Skill C │ │ │ │ - Match Score│ │ - Match Score│ │ - Match Score│ │ │ │ - Confidence │ │ - Confidence │ │ - Confidence │ │ │ │ - History │ │ - History │ │ - History │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ │ │ │ │ └─────────────────┴─────────────────┘ │ │ ↓ │ │ Select Best Skill │ └─────────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────┐ │ Execute Skill │ └────────┬────────┘ ↓ ┌─────────────────┐ │ Handle Result │ └────────┬────────┘ ↓ ┌─────────────────────────────────────────────────────────────────────┐ │ Error Handling & Fallback │ │ │ │ Success? ────────► Return Result │ │ │ │ Fail? ────────┐ │ │ ↓ │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ Fallback Chain │ │ │ │ │ │ │ │ 1. Retry with adjusted parameters │ │ │ │ 2. Try Alternative Skill (if available) │ │ │ │ 3. Defer to Human Operator (if critical) │ │ │ │ 4. Log & Return Error │ │ │ └──────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘
Use this skill when:
Avoid this skill for:
Parse and Analyze Request - Extract intent, entities, and constraints from user input. Checkpoint: All required parameters must be present and in valid format before proceeding.
Score Available Skills - Calculate match scores using multi-factor algorithm:
Checkpoint: Skip to fallback if no skill scores above threshold.
Select Optimal Skill - Choose skill with highest score that meets minimum confidence. Checkpoint: Verify skill has not been disabled or deprecated.
Execute with Fallback - Run skill execution wrapped in retry and fallback logic. Checkpoint: Log all execution attempts for audit trail.
Return or Fallback - Either return successful result or apply fallback chain:
related-skillsCheckpoint: Record outcome with timing and confidence metadata.
def route_zoom_request(
user_intent: str,
zoom_client: ZoomClient,
calendar_service: CalendarService
) -> Dict[str, Any]:
"""Route a natural language request to specific Zoom API operations.
Extracts Zoom-specific entities (meeting_type, duration, participants, recording)
and maps them to the appropriate SDK method. Implements early validation
for required Zoom parameters before API dispatch.
"""
# Early exit: validate required context
if not user_intent or not zoom_client.is_authenticated():
raise ValueError("Missing intent or Zoom authentication context")
# Parse Zoom-specific parameters
parsed_params = _extract_zoom_entities(user_intent)
# Validate against Zoom API constraints
if parsed_params.get("duration", 0) > 240:
raise ValueError("Zoom meetings cannot exceed 240 minutes")
# Route to specific Zoom operation
operation_map = {
"schedule": zoom_client.schedule_meeting,
"join": zoom_client.generate_join_url,
"record": zoom_client.start_recording,
"invite": calendar_service.send_calendar_invite
}
target_op = operation_map.get(parsed_params["action"])
if not target_op:
raise ValueError(f"No matching Zoom operation for intent: {parsed_params['action']}")
# Return structured execution plan (immutable)
return {
"operation": parsed_params["action"],
"params": dict(parsed_params),
"target_method": target_op.__name__,
"requires_calendar_sync": parsed_params.get("send_invite", False)
}
def execute_zoom_operation(
operation_plan: Dict[str, Any],
zoom_client: ZoomClient,
fallback_handler: FallbackHandler
) -> Dict[str, Any]:
"""Execute a mapped Zoom API operation with domain-specific fallback chains.
Handles Zoom rate limits (429), token expiration (401), and meeting state conflicts.
Implements graceful degradation: e.g., if cloud recording fails, falls back to
local recording or notifies participants via email.
"""
params = operation_plan["params"]
method = operation_plan["target_method"]
try:
# Execute primary Zoom API call
result = method(**params)
# Handle Zoom-specific success states
if operation_plan["operation"] == "record":
return {"status": "recording_started", "recording_id": result.get("id")}
elif operation_plan["operation"] == "schedule":
return {"status": "meeting_scheduled", "meeting_url": result.get("join_url")}
return {"status": "success", "zoom_response": result}
except RateLimitError as e:
# Fallback 1: Exponential backoff retry for Zoom API throttling
return fallback_handler.retry_with_backoff(method, params, max_retries=3)
except MeetingConflictError as e:
# Fallback 2: Auto-reschedule to next available slot
return fallback_handler.reschedule_meeting(zoom_client, params, e.conflicting_meeting_id)
except CloudRecordingUnavailableError:
# Fallback 3: Graceful degradation to local recording
return fallback_handler.enable_local_recording(params.get("meeting_id"))
except AuthenticationError:
# Fallback 4: Refresh OAuth token and retry once
return fallback_handler.refresh_zoom_token_and_retry(method, params)
code-philosophy (5 Laws of Elegant Defense) in all logicWhen applying this skill, produce:
Authoritative documentation links for this skill's domain. The model follows markdown links at load time to resolve external references and inline content.
| Skill | Purpose | |