chore(skills): drop OpenAI o-series from llm-tool-best-practices scope

This commit is contained in:
zap
2026-03-05 20:44:57 +00:00
parent a34826908d
commit 06202bcfbe

View File

@@ -138,7 +138,7 @@
- **`tool_choice`:** Default is `auto`. Use `required` to force a call, or named function to force a specific one. Use `allowed_tools` to restrict available tools per turn without breaking prompt cache.
- **Tool search (`defer_loading: true`):** For large ecosystems, defer rarely-used tools. Let the model search and load them on demand — keeps initial context small and accurate.
- **Namespaces:** Group related tools using the `namespace` type with a `description`. Helps model choose between overlapping domains (e.g., `crm` vs `billing`).
- **Reasoning models (o4-mini, GPT-5, etc.):** Do NOT add examples in descriptions — this can hurt reasoning model performance. Pass reasoning items back with tool call outputs (required).
- **Reasoning models (o-series):** Out of scope — not targeted by this workspace.
- **Token awareness:** Function definitions are injected into the system prompt and billed as input tokens. Shorten descriptions where possible; use tool search to defer heavy schemas.
- **`additionalProperties: false`** is required for strict mode — always add it.
- For code generation or high-stakes outputs: keep a human-in-the-loop review step.
@@ -162,7 +162,7 @@
| Examples in tool def | `input_examples` array (recommended) | Inline in description (avoid for reasoning models) |
| Tool response format | Flexible; test JSON/XML/Markdown | String preferred; JSON/error codes acceptable |
| Max tools in context | No hard limit; keep focused | Soft limit ~20; use tool search beyond that |
| Best model for complex tools | Claude Opus | GPT-4.1 / GPT-5 (not nano for parallel calls) |
| Best model for complex tools | Claude Opus | GPT-4.1 / GPT-5 |
| Safety tooling | Built-in thinking/CoT, strict tool use | Moderation API, safety_identifier, HITL |
| Parallel calls | Default on; managed by model | Default on; disable with `parallel_tool_calls: false` |
| Deferred tools | N/A (use fewer tools instead) | `defer_loading: true` + tool search |