菜单
Default to no comments. Only write one when the WHY is non-obvious. Never comments that restate the code. Use any time you're about to write a comment.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
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-comments-only-when-why |
| description | Default to no comments. Only write one when the WHY is non-obvious. Never comments that restate the code. Use any time you're about to write a comment. |
# increment counter above counter += 1).# fix for ticket ABC-123) — that's PR metadata, not code.# Gemini rejects $ref/$defs — flatten before sending.
flattened = self._flatten_schema(schema, defs)
# Idempotent: re-activating a live skill is a no-op (hooks do not re-fire).
if name in self._active_skill_names:
return
# Loop through tools
for tool in tools: # ← restates the code
# Added for the new skill activation PR
self._meta_tool_names = [] # ← rots the moment the PR merges
[[generic-small-diffs]], [[generic-no-premature-abstraction]]