协作头脑风暴
brainstorming
在实现前澄清需求、探索设计选择,并形成清晰的开发方向。
cc-skill-strategic-compact【开发与工程】Implements intelligent cc skill strategic compact with multi-factor skill selection, fallback chains, and adherence to the 5 Laws of Elegant Defense
独立 GitHub 快照 · 自动分类 · 以原作者文档为准
name: cc-skill-strategic-compact compatibility: opencode completeness: 95 content-types:
Orchestrates intelligent skill selection and execution for cc skill strategic compact 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 evaluate_strategic_compact(
task_context: Dict[str, Any],
available_compacts: List[Dict[str, Any]],
min_confidence: float = 0.75
) -> Optional[Dict[str, Any]]:
"""Evaluate available skill compacts against the current task context.
Implements Law 2 (Make Illegal States Unrepresentable) by validating
compact schemas before scoring. Uses multi-factor scoring to determine
the optimal strategic compact for the request.
"""
if not task_context.get("intent") or not available_compacts:
raise ValueError("Task intent and available compacts are required")
task_features = _extract_intent_features(task_context["intent"])
best_compact = None
best_score = 0.0
for compact in available_compacts:
# Law 1: Early exit for disabled/deprecated compacts
if compact.get("status") in ("disabled", "deprecated"):
continue
match_score = _calculate_text_similarity(task_features, compact.get("triggers", []))
history_score = compact.get("historical_success_rate", 0.0)
availability_score = 1.0 if compact.get("health") == "healthy" else 0.5
composite_score = (match_score * 0.5) + (history_score * 0.3) + (availability_score * 0.2)
if composite_score > best_score and composite_score >= min_confidence:
best_score = composite_score
best_compact = compact
if best_compact is None:
return None
# Law 3: Atomic Predictability - return fresh dict
return {
"compact_id": best_compact["id"],
"confidence": best_score,
"selected_at": time.time(),
"fallback_chain": best_compact.get("fallbacks", [])
}
def execute_compact_with_fallback(
compact_config: Dict[str, Any],
execution_context: Dict[str, Any],
max_retries: int = 2
) -> Dict[str, Any]:
"""Execute a strategic compact with built-in resilience patterns.
Follows Law 4 (Fail Fast, Fail Loud) by immediately halting on
invalid state errors and routing transient failures through the
configured fallback chain.
"""
if not compact_config.get("steps"):
raise CompactExecutionError("Compact must define at least one execution step")
validated_context = _validate_compact_inputs(execution_context, compact_config)
attempt = 0
while attempt <= max_retries:
try:
result = _run_compact_steps(compact_config["steps"], validated_context)
return {
"status": "success",
"compact_id": compact_config["id"],
"output": result,
"attempts": attempt + 1,
"latency_ms": time.time() * 1000
}
except InvalidStateError as e:
# Law 4: Fail immediately on invalid state
raise CompactExecutionError(f"Invalid state in compact {compact_config['id']}: {e}") from e
except TransientError as e:
attempt += 1
if attempt > max_retries:
return _apply_compact_fallback(compact_config, validated_context)
# Fallback exhausted
return {
"status": "fallback_triggered",
"compact_id": compact_config["id"],
"fallback_result": _route_to_human_operator(compact_config, validated_context)
}
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 | |