用途:当任务实质影响 HTTP 请求生命周期或协议行为时应用该规范。前端工程与后端工程技能负责运行时结构,本技能负责跨该边界的语义;REST/OpenAPI 资源与表征设计交由 best-openapi-design 技能负责。
主要能力与做法:一是端到端追踪完整请求生命周期,覆盖用户意图、客户端校验与构造、认证与授权、领域操作与持久化、响应或异步结果、调用方对账与重试及可见失败,并为每个适用状态确定归属模块与稳定协议语义。二是定义一份完整 HTTP 契约,包括方法与规范路径,路径、查询、头、Cookie、体输入,成功与错误表征,状态码与稳定错误标识,认证授权预期,缓存与校验器及失效,幂等、并发、重试、取消与超时语义,关联与 Trace 传播,以及兼容与迁移行为。服务端传输层仍需校验不可信输入;领域与应用的失败只在传输边界翻译为 HTTP。三是身份与权限分离:在执行边界认证并产出规范化不可变主体,再针对资源、操作、归属、租户、状态与字段单独授权。四是让写操作在重复与并发下安全:为刷新、重复提交、超时、客户端重试、并发更新和未知结果定义行为,采用幂等标识、条件请求、版本检查或数据存储约束;只在该操作语义的边界重试瞬时故障,并要求幂等、有限次数、退避、抖动与总时限。五是集中协议策略,在框架原生请求响应边界处理校验、错误映射、认证提取、关联、安全头、序列化、可观测性与审计。六是保护每次信任转换,凭据与特权数据不得进入 URL、重定向、日志、错误体、缓存;按平台控制 Cookie 范围、传输安全、CSRF、CORS、重定向、上传与内容处理。七是关联完整交互,从调用方经 HTTP 边界、下游依赖与异步工作传播稳定的请求与 Trace 上下文,服务端边界负责唯一结构化诊断完成事件。
完成门禁:当生命周期阶段无明确归属、方法与缓存或并发等行为含糊矛盾、把客户端校验当服务端校验、把认证当授权、重复或不确定写入可能静默重复不可逆操作、HTTP 类型渗入业务策略、协议策略在处理器中重复、凭据或敏感体可进入日志缓存错误、交互无法关联、或适用校验门禁未满足时,拒绝视为完成。安装命令、价格与平台支持等信息资料未提供。