关于 mathodology-gateway-api
供团队研究或重建 Mathodology 旧版网关与 API 的架构技能，记录服务边界和工作流概念；当前分支不含实现文件，不用于重建网关。
主要功能
- 01记录历史网关职责
- 02服务与产物边界指导
- 03事件日志与可复现性概念
- 04API 合约和导出考量
适用场景
- 01依据历史记录规划网关重建
- 02界定运行任务与产物的边界
- 03定义输出模式和提交包
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/mathodology-gateway-api确认已加载。
附带文件agents/openai.yaml
详细介绍
Mathodology 网关 API 归档
范围
此技能保留了关于旧版 Mathodology 网关和公共 API 接口的架构知识。
当前 GitHub 分支不包含网关源代码、契约、迁移文件、测试或生成的客户端。请将此技能用于归档指导和重建规划，而非在此检出版本中编辑或编译网关。
已归档概念
旧版网关是产品的服务边界，负责：
- 接收建模运行请求
- 运行状态、事件流和制品访问
- 开发和托管使用场景的身份验证
- 通过应用状态和后端存储进行持久化
- LLM 提供商路由、流式传输、回退和成本核算
- 论文导出和投稿材料包生成
- 与 worker 和 Web UI 共享的 API 契约
工作流适配器职责
在奖项级工作流中，如果投稿材料包需要参考旧版网关设计进行服务或产品层面的推理，请使用此技能：
- 明确划分用户提示词、计算、制品和最终材料包之间的边界
- 保留阶段日志和可复现性记录中的事件日志思路
- 将导出内容和投稿材料包视为一等交付物
- 为代码、数据、表格、图表和论文各部分指定输出架构时，保留 API 契约思维
Codex Agent 应将此作为架构指导，而非重建已移除网关的指令。
仅当材料包边界、制品、导出内容或可复现性契约不明确时，Claude Code 子 Agent 才应参考此技能。
如何维护此技能
更新已归档的网关指导时：
- 除非已通过 Git 历史记录验证，否则应将实现细节标记为历史信息。
- 优先描述行为和契约概念，而非缺失的源代码路径。
- 不要将构建、测试、迁移或契约生成命令作为当前验证方式添加。
- 如果需要了解确切的路由行为，请在单独的工作树中从较早的提交中恢复。
- 确保跨边界说明与流水线和 Web UI 归档技能保持一致。
有用的问题
遇到以下问题时，请使用此技能：
- 旧版网关负责哪些工作？
- 网关概念如何连接 worker 运行、Web 流式传输、导出内容和 LLM 提供商？
- 重建 API 契约之前应保留哪些内容？
- 哪些历史领域在实现工作前需要检查 Git 历史记录？
当前分支规则
对当前分支的任何修改都应仅限于技能或文档。除非用户明确更改仓库策略，否则不要将网关源代码、契约、迁移文件、生成的客户端、服务配置或测试添加回此分支。
评论
支持 Markdown