AgentSkillsCN

openapi-chromadb

电力系统网络数据格式与拓扑结构。在解析母线、发电机与支路数据以进行潮流分析时，这一技能将为你提供极大便利。

SKILL.md
--- frontmatter
name: openapi-chromadb
description: Automates updating chromadb when ChromaDB OpenAPI spec changes. Fetches latest spec, compares against current, generates changelogs and prioritized implementation plans. Use for: (1) Checking for API updates, (2) Generating implementation plans for spec changes, (3) Creating new models/endpoints from spec, (4) Syncing local spec with upstream. Triggers: "update api", "sync openapi", "new endpoints", "api changes", "check for updates", "update spec", "api version", "fetch spec", "compare spec", "what changed in the api", "implementation plan".

OpenAPI Toolkit (chromadb)

Uses shared scripts from openapi-toolkit.

Prerequisites

  • •Python 3.9+ with pyyaml installed
    • •Important: Install for your active Python version: python3 -m pip install pyyaml --user
    • •Verify: python3 -c "import yaml; print(yaml.__version__)"

Working Directory Requirements

Different scripts require different working directories. See the shared README for details.

ScriptWorking Directory
fetch_spec.py, analyze_changes.pyRepository root
verify_*.py, generate_*.pyPackage root (packages/chromadb)

Quick Start

bash
# === FROM REPOSITORY ROOT ===

# Fetch latest spec
cd "$(git rev-parse --show-toplevel)" && \
python3 .claude/shared/openapi-toolkit/scripts/fetch_spec.py \
  --config-dir packages/chromadb/.claude/skills/openapi-chromadb/config

# Analyze changes (specs auto-located from config)
cd "$(git rev-parse --show-toplevel)" && \
python3 .claude/shared/openapi-toolkit/scripts/analyze_changes.py \
  --config-dir packages/chromadb/.claude/skills/openapi-chromadb/config \
  --format all

# === FROM PACKAGE ROOT ===

# IMPORTANT: Check API coverage (spec auto-located)
cd "$(git rev-parse --show-toplevel)/packages/chromadb" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_coverage.py \
  --config-dir .claude/skills/openapi-chromadb/config --verbose

# Verify implementation (barrel files auto-discovered)
cd "$(git rev-parse --show-toplevel)/packages/chromadb" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_exports.py \
  --config-dir .claude/skills/openapi-chromadb/config

cd "$(git rev-parse --show-toplevel)/packages/chromadb" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_model_properties.py \
  --config-dir .claude/skills/openapi-chromadb/config \
  --spec specs/openapi.json

# Re-run coverage to confirm full implementation
cd "$(git rev-parse --show-toplevel)/packages/chromadb" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_coverage.py \
  --config-dir .claude/skills/openapi-chromadb/config

Troubleshooting

  • •No changes detected: Analysis shows all zeros - package is up-to-date, no action needed
  • •Unexported files warning: Add internal utility files to skip_files in config/package.json
  • •Coverage < 100%: Missing APIs need implementation before other updates

Package-Specific References