AgentSkillsCN

provider-integration

通过稳定的适配器合约与韧性控制,集成内外部供应商。在新增或审计供应商API、规范数据合约、定义回退行为,或在发布前验证供应商集成就绪状态时使用此技能。

SKILL.md
--- frontmatter
name: provider-integration
description: Integrate external/internal providers through stable adapter contracts and resilience controls. Use when adding or auditing provider APIs, normalizing data contracts, defining fallback behavior, or validating provider integration readiness before release.

Provider Integration

Use this skill to implement provider integrations with strict contract and fallback behavior.

Workflow

  1. Define scope and constraints.
  • Define provider contract, auth model, rate limits, and error taxonomy.
  • Capture objective metrics, bounds, and release blockers.
  1. Design implementation plan.
  • Design adapter boundaries and schema normalization rules.
  • Keep ownership and dependency boundaries explicit.
  1. Execute and iterate.
  • Implement in small, traceable increments.
  • Record run/build context for reproducibility.
  1. Validate contract integrity.
  • Validate contract compliance, retry/fallback behavior, and observability.
  • Treat contract breaches as blockers.
  1. Prepare handoff.
  • Deliver adapter patch plan, migration notes, and verification steps.
  • Include exact commands and acceptance criteria.

Output Contract

Return:

  1. Context: goals, assumptions, constraints.
  2. Validation: pass/fail checks and key deltas.
  3. Changes: concrete file-level updates.
  4. Commands: commands and expected outputs.
  5. Risks: unresolved issues and limits.

References

  • references/workflow.md: detailed execution flow.
  • references/checklist.md: sign-off checklist.

Execution Rules

  • Keep decisions measurable and reversible.
  • Keep validation criteria explicit before iteration.
  • Treat schema drift and unhandled provider errors as blockers.