mcpField
T
technical-integrations

technical-integrations

github.com/vincentkoc开发11194 次安装2 天前更新
代码仓库

关于 technical-integrations

此工作流技能依据现有代码库模式设计和审查外部供应商集成，涵盖调研、RFC 提案、API 与 SDK 方案，以及验证和发布清单。

主要功能

  1. 01区分集成工作模式
  2. 02盘点现有集成模式
  3. 03遵循供应商无关原则
  4. 04编写架构与 RFC 提案
  5. 05规划执行、验证和发布

适用场景

  1. 01新增供应商前评估现有模式
  2. 02审查集成 RFC
  3. 03规划 API 或 SDK 集成点
  4. 04准备发布检查并识别风险

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vincentkoc/dotskills --skill technical-integrations

安装后在 Claude Code 中输入/technical-integrations确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
design-and-rfc.md
hunt-and-inventory.md
implementation-plan.md
principles.md
review-checklist.md

详细介绍

技术集成

目的

使用现有内部模式设计和评审外部供应商集成，并提供不依赖特定供应商或框架的 API、RFC、SDK 和发布规划工作流。

何时使用

  • 添加新的第三方／供应商集成。
  • 在不破坏兼容性的前提下扩展现有集成接口。
  • 在实现前编写或评审集成 RFC。
  • 定义 SDK／API 集成点和交付计划。

工作流

  1. 确定模式：discover、design、review 或 implementation-plan。
  2. 运行 references/hunt-and-inventory.md，收集当前集成证据和模式。
  3. 使用 references/principles.md，确保遵守不依赖特定供应商或框架的约束。
  4. 对于架构和提案工作，遵循 references/design-and-rfc.md。
  5. 对于执行顺序规划，遵循 references/implementation-plan.md。
  6. 对于 QA 检查，应用 references/review-checklist.md。
  7. 返回交付成果，并明确说明决策、权衡和未解决的风险。

流程

stateDiagram-v2
    [*] --> ClassifyRequest
    ClassifyRequest --> HuntAndInventory
    HuntAndInventory --> ApplyPrinciples
    ApplyPrinciples --> SelectWork
    state SelectWork <<choice>>
    SelectWork --> Deliverables: discovery only
    SelectWork --> DesignAndRFC: architecture or proposal
    SelectWork --> ImplementationPlan: execution sequencing
    SelectWork --> ReviewChecklist: review
    DesignAndRFC --> ReviewChecklist: QA pass in scope
    DesignAndRFC --> Deliverables: proposal only
    ImplementationPlan --> ReviewChecklist: QA pass in scope
    ImplementationPlan --> Deliverables: plan only
    ReviewChecklist --> Deliverables
    Deliverables --> [*]

输入

  • 集成目标和目标供应商的能力。
  • 现有代码库模式（API、SDK、身份验证、可观测性、错误模型）。
  • 兼容性约束（向后兼容性、版本控制、发布策略）。
  • 范围（仅发现、RFC 草案、实施计划或完整评审）。

输出

  • 集成清单和模式基线。
  • 达到 RFC 质量的提案，包含选项和决策依据。
  • API 和 SDK 集成设计计划。
  • 验证和发布检查清单，以及未解决的风险。

评论

支持 Markdown