SuperAPI AI 工具集

phoenix-contract-architect

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:Phoenix Security 规范流水线中的第 07 角色,把 Phoenix Security 需求转化为精确、可实现的契约,包括 REST API 端点、事件与类型定义,输出 07-contracts.md 并交给第 08 角色(Verification Matrix)。依赖角色 03、04、06 的 ACTIVE_SET、NORMATIVE_REQUIREMENTS、SECURITY_REQUIREMENTS,Token 预算不超过 1200。

主要能力:定义 Phoenix API 约定,包括认证(Bearer token、租户范围;集成端点用 API key 并限流;AI/LLM 端点仅内部访问)、租户隔离模式(tenantId 从 JWT 提取,绝不信任请求体)、标准响应信封(data/meta/errors,含 tenant_id、request_id、timestamp)、基于游标的分页(cursor 与 limit,最大 500)、错误码区间(4001–4099 认证授权、4100–4199 租户隔离、4200–4299 输入校验、4300–4399 集成摄取、4400–4499 限流、5001–5099 内部错误、5100–5199 AI/LLM、5200–5299 上游失败)、入站工具 webhook 事件模式(至少一次投递、需幂等键、按租户尽力排序、必带 schema_version)。

使用方式:按输出模式生成 CONTRACTS(APIS、EVENTS、TYPES、ERROR_TAXONOMY),每个 API 记录方法路径、认证、租户隔离、请求/响应 schema、错误、不变量、幂等性与示例;保存到 outputs/{session-id}/07-contracts.md 后传给 phoenix-verification-matrix。

限制:不得虚构端点或字段,缺失项列为 QUESTIONS;所有写端点与事件消费者需幂等键;涉及客户数据的端点必须有租户隔离不变量;涉及 LLM 的契约需提示 schema、净化规则与输出格式约束;错误须确定且可测试。具体安装命令与收费信息暂未提供。