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 Gateway API アーカイブ
範囲
このスキルは、以前の Mathodology ゲートウェイとパブリック API の領域に関するアーキテクチャ知識を保存します。
現在の GitHub ブランチには、ゲートウェイのソース、コントラクト、マイグレーション、テスト、生成されたクライアントは含まれていません。このスキルは、アーカイブされたガイダンスや再構築計画に使用してください。このチェックアウトでゲートウェイを編集またはコンパイルするためのものではありません。
アーカイブされた概念
以前のゲートウェイは、プロダクトのサービス境界として機能していました。
- モデリング実行のリクエスト受付
- 実行ステータス、イベントストリーミング、成果物へのアクセス
- 開発環境とホスト環境での認証
- アプリケーションの状態とバックエンドストアを通じた永続化
- LLM プロバイダーのルーティング、ストリーミング、フォールバック、コスト計上
- 論文のエクスポートと投稿パッケージの生成
- ワーカーと Web UI で共有される API コントラクト
ワークフローアダプターとしての役割
アワードレベルのワークフローでは、投稿パッケージに以前のゲートウェイ設計に基づくサービスまたはプロダクト的な考え方が必要な場合に、このスキルを使用します。
- ユーザープロンプト、計算、成果物、最終パッケージの間に明確な境界を定義する
- フェーズログと再現性の記録にイベントログの考え方を維持する
- エクスポートと投稿パッケージを第一級の成果物として扱う
- コード、データ、表、図、論文のセクションの出力スキーマを指定する際に、API コントラクトの考え方を維持する
Codex エージェントは、これをアーキテクチャのガイダンスとして使用してください。削除されたゲートウェイを再構築する指示として扱わないでください。
Claude Code のサブエージェントは、パッケージの境界、成果物、エクスポート、再現性のコントラクトが不明確な場合にのみ、これを参照してください。
このスキルの保守方法
アーカイブされたゲートウェイのガイダンスを更新する場合：
- Git 履歴で確認できない限り、実装の詳細には履歴上の情報であることを明記してください。
- 欠落しているソースパスよりも、動作とコントラクトに関する概念を優先してください。
- 現在の検証手順として、ビルド、テスト、マイグレーション、コントラクト生成のコマンドを追加しないでください。
- 正確なルートの動作が必要な場合は、別のワークツリーで古いコミットから復元してください。
- 境界をまたぐ注記は、パイプラインと Web UI のアーカイブスキルに沿った内容にしてください。
役立つ質問
次のような質問には、このスキルを使用してください。
- 以前のゲートウェイは、どのような責務を担っていましたか？
- ゲートウェイの概念は、ワーカーの実行、Web ストリーミング、エクスポート、LLM プロバイダーとどのようにつながっていましたか？
- API コントラクトを再構築する前に、何を維持すべきですか？
- 実装作業の前に Git 履歴を調査する必要があるのは、どの領域ですか？
現在のブランチに関するルール
現在のブランチでの編集は、スキルまたはドキュメントに限定してください。ユーザーがリポジトリの方針を明示的に変更しない限り、ゲートウェイのソース、コントラクト、マイグレーション、生成されたクライアント、サービス設定、テストをこのブランチに戻さないでください。