AI 接入 Skill（Claude Code / Codex）

如果你使用 Claude Code 或 Codex，希望 AI 直接帮你在项目里完成接入，可以使用本包内置的 Skill。

这个 Skill 只面向公开接入能力，会帮你根据项目技术栈和业务场景选择合适的接入方式：

• 找到共享请求入口（Axios 实例、fetch 封装、SDK 请求函数、wx.request 等）
• 判断该走 Axios 安装模式、Wrapper 模式、微信平台快捷入口、按需 core 入口，还是纯配置模式
• 生成最小可用规则（如表单防重、列表复用、配置拉取重试、上游熔断保护）
• 保留 requestGuard: false 这类请求级逃生口

它不会做什么

Skill 不会暴露内部实现、源码结构或未发布能力。问到底层原理时它会拒绝并把你引导回公开接入方式。

使用步骤

第一步：安装 npm 包

npm install @hydd/request-guard
# 或
pnpm add @hydd/request-guard
# 或
yarn add @hydd/request-guard

第二步：把 Skill 拷到 AI 工具的技能目录

Skill 随 npm 包一起分发，安装后位于：

node_modules/@hydd/request-guard/skills/request-guard/

把整个 request-guard/ 目录拷到对应工具的技能目录，并保持目录名为 request-guard：

Claude Code（项目级）

mkdir -p .claude/skills
cp -r node_modules/@hydd/request-guard/skills/request-guard .claude/skills/

Claude Code（用户级）

mkdir -p ~/.claude/skills
cp -r node_modules/@hydd/request-guard/skills/request-guard ~/.claude/skills/

Codex

mkdir -p "$CODEX_HOME/skills"
cp -r node_modules/@hydd/request-guard/skills/request-guard "$CODEX_HOME/skills/"

如果你是直接克隆了本仓库，也可以用仓库根目录下的 skills/request-guard/。

第三步：在 AI 中直接提需求

你可以像下面这样直接描述你的项目场景（Codex 用 $request-guard 触发，Claude Code 直接描述即可）：

用 request-guard 给我的 React + axios 项目接入表单防重复

用 request-guard 给我的 Next.js fetch helper 接入配置拉取重试

用 request-guard 给我的微信小程序接入下单防重，包体越小越好

用 request-guard 保留我现有 sdk.request(method, url, data, options) 签名，接入支付防重

TIP

Skill 是可选增强能力。如果你不使用 Claude Code / Codex，直接按 三大接入方式 手动接入即可。