AgentSkillsCN

openapi-mistral

利用对偶值从直流最优潮流（DC-OPF）解中提取节点电价（LMP）。当你需要计算节点电价、储备清算价格，或开展价格影响分析时，这一技能将为你提供有力支持。

SKILL.md
--- frontmatter
name: openapi-mistral
description: Automates updating mistralai_dart when Mistral AI 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 (mistralai_dart)

Uses shared scripts from openapi-toolkit.

Prerequisites

  • •MISTRAL_API_KEY environment variable set (for integration tests)
  • •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/mistralai_dart)

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/mistralai_dart/.claude/skills/openapi-mistral/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/mistralai_dart/.claude/skills/openapi-mistral/config \
  --format all

# === FROM PACKAGE ROOT ===

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

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

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

# Re-run coverage to confirm full implementation
cd "$(git rev-parse --show-toplevel)/packages/mistralai_dart" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_coverage.py \
  --config-dir .claude/skills/openapi-mistral/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
  • •API key error: Export MISTRAL_API_KEY environment variable

Package-Specific References

External References