القائمة
Validate at system boundaries, trust internally. No defensive fallbacks for impossible cases. Use whenever adding try/except, validation, or null-checks.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Router for any non-trivial echo-sdk task. Maps user intent to the right module skill and diagram. Invoke FIRST for any change to src/echo/ before reaching for a specific module skill.
Recipe for adding a new provider (LLM, transcriber, eval, prompt). Use whenever adding Cohere, Mistral, Deepgram, Phoenix, Promptlayer, etc. — anything that plugs into an existing get_*() factory.
End-to-end recipe for defining a Skill bundle and wiring it into a GenericAgent with the right activation mode and tool registry. Use when extending agent capability via swappable skills rather than baking tools in.
Building agents with BaseAgent / GenericAgent, including skill registration, activation modes (llm vs manual), and system-prompt composition. Use when editing src/echo/agents/ or building a new agent subclass.
Audio transcription provider abstraction (Gemini, EkaCare). Use when transcribing audio, adding a new transcriber, or shaping AudioInput.
Postgres support — asyncpg client, schema-aware binder, PgQueryTool surface. Use when querying postgres from a tool, modifying the binder, or adding a new DB engine.
| name | generic-error-handling-at-boundaries |
| description | Validate at system boundaries, trust internally. No defensive fallbacks for impossible cases. Use whenever adding try/except, validation, or null-checks. |
if x is None: ... for values your own code just constructed — that's noise.except Exception: pass. Either handle a specific exception type with a meaningful recovery, or let it propagate.MCPExecutionError (already wrapped); HTTP 401 from a provider → bubble as the provider's documented exception type.asyncio.CancelledError after cleanup; never absorb it.AgentResult(error=...), not five layers deep._run_agent / _run_agent_stream are the boundary that converts exceptions to AgentResult(error=...) / StreamEvent(ERROR). Tools, LLM providers, and skills should raise — don't catch.MCPError subclasses at the boundary with the MCP server.try: result = await tool.run() except Exception as e: return None → swallows real errors; tool failures become silent successes.if config and config.foo and config.foo.bar for Pydantic configs → if construction succeeded, the chain is fine.Exception to log + re-raise → just let it propagate; the boundary logs.[[generic-small-diffs]], [[python-async-discipline]]