site-api-adapter

name	site-api-adapter
standard_type	conditional_escalation
description	Conditional post-verification skill for turning already stable reverse-engineering findings into a reusable site API adapter: adapter.yaml, request/response schema, route classification, prompt-router rules, runbook, smoke tests, and service boundary documentation. Trigger only when the user explicitly asks for adapter标准化, adapter.yaml, schema/runbook/prompt-router, 接口化沉淀, or when website-314-api-delivery calls it after real API reproduction is verified. Do not trigger while endpoints, sign/token, challenge/WAF, or business acceptance are still being discovered.
platforms	["web","h5"]

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.