managing-cache-and-optimization

在管理 Shannon CLI 性能和成本时使用 - 检查缓存统计信息,清除过期条目,设置预算,了解自动模型选择和成本优化。

📖 中文导读:在管理 Shannon CLI 性能和成本时使用 - 检查缓存统计信息,清除过期条目,设置预算,了解自动模型选择和成本优化。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: managing-cache-and-optimization description: Use when managing Shannon CLI performance and costs - check cache statistics, clear stale entries, set budgets, understand automatic model selection and cost optimization

Managing Cache and Optimization

Overview

Shannon CLI provides automatic caching and cost optimization across all operations.

Cache Management

Check statistics:

shannon cache stats

Shows: Hit rate, size, savings (USD and time)

Clear cache:

shannon cache clear         # All caches
shannon cache clear --type analysis  # Just analysis cache

Cache layers (3 tiers):

  • Analysis: 7-day TTL
  • Command: 30-day TTL
  • MCP: Indefinite

Performance targets:

  • Hit rate: >60% (good), >80% (excellent)
  • Cache speed: <500ms
  • Size: <500MB total

Cost Optimization

Set budget:

shannon budget set 10.00  # $10 limit
shannon budget status     # Check spending

Automatic model selection:

  • Simple tasks → haiku (cheapest)
  • Complex tasks → sonnet (balanced)
  • Auto-selected per complexity

View optimization:

shannon optimize

Shows: Potential savings, model recommendations

Quick Reference

Command Purpose
cache stats View hit rates and savings
cache clear Clear stale entries
budget set N Set spending limit
budget status Check remaining budget
optimize View cost-saving suggestions

When to Clear Cache

  • After Shannon Framework updates
  • Cache size >400MB
  • Hit rate <40% (stale entries)
  • Debugging cache-related issues