用途:设计并实现以 GitHub 为中心的集成(API、Apps、Webhooks),包含安全鉴权、可观测性与可回滚的自动化流程。适用于需要 GitHub 自动化或 Webhook 桥接、把 GitHub 与外部系统集成、以及对跨仓库 GitHub API 调用做审计的场景。不适用于发布编排、跨仓库活动、项目看板设计,这些分别路由到其他技能。
主要能力与流程:先评估集成面(梳理仓库、事件、所需权限,确认鉴权模型如 GitHub App、PAT、OIDC 及轮换计划,识别速率限制与审计要求);再设计事件与 API 流程(Webhook 载荷处理、重试、签名校验,制定幂等、去重与退避策略,规划数据映射与错误处理);随后实现自动化(以最小权限构建或复用脚本/actions,添加日志指标与沙箱测试,经干跑与审批后放行生产);最后验证与运营(集成测试与故障注入,配置监控告警仪表盘,编写运行手册、回退方案与支持联系人)。
使用方式:遵循库优先协议,写代码前先查 .claude/library/catalog.json 的库目录,匹配度大于 70% 时复用或最小改造;再查 .claude/docs/inventories/LIBRARY-PATTERNS-GUIDE.md 的模式指南,存在模式则按文档方法执行;最后查 D:\Projects* 现有项目,找到则抽取适配。无匹配时才新建并回填库。
必要产物:SKILL.md、readme.md(含用法示例)、examples/、tests/、resources/、shared-scripts/、references/(含 API 约束)。输出整合设计文档、鉴权与密钥管理计划(含轮换节奏)、实现产物与测试证据、监控告警计划、含回滚步骤与责任人的运行手册。
限制与护栏:必须对抗性验证,覆盖边界、失败路径与回滚演练;分离硬性、软性与推断约束并确认推断项;置信度上限定为 0.70(推断类),声明不得超上限;MCP 会话需标注 WHO/WHY 并留存证据链接;避免无文档变更、缺少回滚、跳过测试或无审批的无界自动化。