-
[NA] [SDK] feat: add opik-integrations assistant skill for building SDK integrations (#7304)
frostbyte_neo 发布于
2026-07-01 13:56:43 +00:00 - [NA] [SDK] feat: add opik-integrations assistant skill for building SDK integrations
Adds two agent skills (source under .agents/, synced to .claude/ via
make claude)
and their slash commands, for authoring Opik integrations. No product/SDK code changes.-
opik-integrations (+ /comet:build-opik-integration): build/update/maintain
integrations that ship inside sdks/python and sdks/typescript. Encodes the
integration anatomy, the method-patching / callback / OpenTelemetry patterns,
and a questionnaire-first, autonomous multi-phase workflow: investigate →
collect → design → implement (clone the closest sibling) → verify via the Opik
MCP (with SDK REST read-back fallback) → test → document → high-level report.
Includes Python/TypeScript anatomy references and an integration docs guide. -
opik-external-integrations (+ /comet:build-opik-external-integration): build
integrations that live outside this repo (standalone opik-* packages, or
upstream contributions such as LiteLLM/Dify), gated to activate only on
external-repo requests.
Also indexes both skills in .agents/skills/README.md.
Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com
- docs(skills): trim integration command docs to reference workflow.md
Addresses review on #7304: the two build-opik-*-integration command docs
restated the full Phase 0-8 playbook that already lives in each skill's
workflow.md, so they duplicated it and had drifted out of sync. Collapse both
Steps sections to a thin pointer at workflow.md (the single source of truth),
keeping only the command-specific Overview + questionnaire.This also removes the two drift-induced contradictions the duplicated text
carried:- build-opik-integration Overview no longer claims a mandatory human approval
gate before any code — the design gate only pauses in interactive mode; an
autonomous run records the design and proceeds. - the Prepare "record blockers and continue" wording is gone; the Overview now
states verifiability is a hard gate for new/update (stop before writing code
when nothing can verify it).
Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com
- docs(skills): add external-integration references to seed research
Adds references.md to the opik-external-integrations skill: a curated,
verified list of known external Opik integrations with their GitHub repo and
Opik-docs URLs, so the research phase starts from concrete links instead of
blind exploration.- Standalone opik-* packages/plugins (comet-ml org): opik-project-template
(cookiecutter scaffold — the clone source for a new standalone package),
opik-openclaw, opik-claude-code-plugin, opik-codex-plugin, opik-kong-plugin. - Upstream host contributions with Opik docs pages: LiteLLM, Dify, n8n,
Flowise, Langflow. - Plus discovery pointers (Opik docs integrations index, comet-ml org search).
SKILL.md and workflow.md Phase 0 now point at it as the first stop once the
target is known.Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com
Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
下载附件