site-api-adapter

# Site API Adapter ## Do NOT Trigger When - 用户的接口还没逆向稳定，处于"找加密入口/补环境/WAF 保护分类"阶段（沉淀必须在能稳定复现之后） → 切到 `reverse-js-crawler` / `imperva-waf-reese84` - 用户只要单次脚本/采集数据，不会复用，不需要 schema/runbook → 切到 `reverse-js-crawler` - 用户要求"完整 FastAPI 接口测试交付"、314 接入请求或本地基础框架接入 → 切到 `website-314-api-delivery`（让它做总控，本 skill 是它的 references 输出之一） - 用户做的不是 Web/H5 接口沉淀 → 不属于本仓库范围 - 用户问的是"skill 评分" → 切到 `skills-evaluation-governance` ## Purpose 把单站点逆向结果升级为可复用、可回归、可交接的接口化单元。这个 Skill 关注沉淀和标准化，不负责深度还原某个 token。 ## Standard LOOP Adapter Boundary This skill is a `conditional_escalation`: it only runs after endpoint, sign/token, challenge/WAF, and business acceptance questions are resolved or explicitly scoped as blocked. Adapter output must preserve pure API delivery constraints and must not treat browser-captured replay, copied cookies, or browser profiles as stable adapter inputs. ## Workflow 1. 输入归档和分类： - 站点信息、页面入口、接口列表、参数依赖、认证/风控状态、样本响应。 - 标记 market、locale、currency、stage、protection、framework。 2. 生成 adapter： - `adapter.yaml`：站点、市场、入口、接口、路由、依赖、风控类型、限流策略。 - `schema.json`：请求/响应结构、必填字段、错误码、字段映射。 - `runbook.md`：如何验证、如何排查、如何扩展。 3. 设计 prompt-router： - 把用户请求分类为纯 HTTP、JS runtime、浏览器诊断、WAF 专项、FastAPI 接口测试交付、本地基础框架接入、不可自动化。 - 输出 JSON，不能只输出自然语言。 4. 写 smoke tests： - 至少覆盖一个成功路径、一个业务错误、一个保护/不可用路径。 - 记录稳定性循环的 exact code/message/count。 5. 维护边界： - adapter 只描述站点能力和调用规范。 - 加密实现放 crypto/runtime。 - 业务服务放 services。 - 反爬专项放 anti_bot。 ## Success Criteria - adapter 能表达接口、依赖、保护、路由、测试和失败边界。 - prompt-router 能输出结构化分类，不靠自然语言猜测。 - 已区分 adapter 沉淀、JS 逆向、WAF 专项、FastAPI 接口测试交付和可选本地基础框架接入。 - 已把站点/市场差异写入站点经验库。 - 已有 smoke、negative、regression 或 boundary eval。 ## Tool Policy - **开始实现前 Read `~/.claude/skills/karpathy-guidelines/SKILL.md`**,确认 4 条原则:Think Before Coding / Simplicity First / Surgical Changes / Goal-Driven Execution。这是基础层规范,所有执行类 skill 强制依赖。 - **遇到逆向运行时问题(断点/时间/cookie/TLS 指纹/风控恢复/接口变更)Read `~/.claude/skills/oh_my_reverse_skill/99-SKILLS治理/10-逆向运行时常见问题.md`**。 - **输出结论、扩范围或做并发前 Read `~/.claude/skills/oh_my_reverse_skill/99-SKILLS治理/11-AI事实证据规约.md` / `12-反泛化与任务收敛规约.md` / `13-并发指纹与会话隔离规约.md`**。 - **改端点/字段/状态/保护/实现/eval 前后 Read `14-知识图谱行程与关联规约.md` / `15-AI变更风险与回归校验规约.md`,并更新 knowledge-graph.md / impact-regression.md**。 ## Boundaries - 这是接口化沉淀 Skill，不是 token 深度还原 Skill。 - 不负责具体 WAF token 逆向；遇到 WAF 切到 `imperva-waf-reese84`。 - 不负责完整 FastAPI 接口测试交付或本地基础框架接入；遇到全流程交付切到 `website-314-api-delivery`。 ## Governance If the user asks for FastAPI interface test delivery or implementation through a local base framework such as 314, do not stop at adapter design. Use `website-314-api-delivery` as the orchestrator, then produce adapter/schema/runbook as part of the delivery. - Version: 0.2.0 - Status: scorecard baseline - Site memory: adapter decisions should update `站点经验库/<domain>/route-decisions.md` and `market-matrix.md`. - Backtest: include adapter-from-notes, prompt-router, negative token-reverse, and regression classification evals. - CI: use Skill Bench or local backtest; quick_validate must pass before accepting changes. ## References - `references/adapter-schema.md`: adapter 字段建议。 - `references/prompt-router.md`: 分类输出规范。 - `references/governance.md`: versioning, change log, Skill Bench, GitHub CI, quick_validate, and drift-test policy.