菜单
uv + pyproject.toml conventions for echo-sdk — adding deps, extras, scripts; Python 3.11+. Use when editing pyproject.toml or running dep commands.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | python-packaging-uv-pyproject |
| description | uv + pyproject.toml conventions for echo-sdk — adding deps, extras, scripts; Python 3.11+. Use when editing pyproject.toml or running dep commands. |
Build tool: uv. Python >=3.11. Lock file: uv.lock (committed).
uv add <pkg> (modifies pyproject.toml + uv.lock). For dev/test: uv add --dev <pkg>.[project.optional-dependencies] directly:
[project.optional-dependencies]
cohere = ["cohere>=X.Y"]
all = [..., "cohere>=X.Y"] # always update umbrella
uv lock to refresh.uv run pytest, uv run python examples/basic_usage.py — uv run ensures the project env.[project].version in pyproject.toml. Tag the commit.>= for runtime deps unless a known incompat forces a cap. Avoid == outside lockfile.pydantic>=2.12.3, orjson, pyyaml.bedrock, openai, anthropic, gemini, postgres, mcp, langfuse, all.pytest, pytest-cov, pytest-asyncio, python-dotenv.uv.lock by hand → regenerate via uv lock.[dependency-groups] when it should be [project.optional-dependencies] (or vice versa) → check existing pattern in pyproject.toml first.all extra when adding a new provider extra.pip install -e . for dev → use uv sync --all-extras instead.[[python-optional-deps]], [[echo-sdk-adding-a-provider]]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.