本文へ移動
cccskills
無料GitHub で公開日本語紹介

api-and-interface-design

RESTやGraphQL、モジュール間の型、コンポーネントのpropsなどを、利用側が予測しやすく変更にも強いインターフェースとして設計するための指針を示します。

原文原文の説明を見る

Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.

LeoYeAI/agent-master-skillsスター 2,193(GitHub 2,193 + cccskills 0)

実行スコア 未検証

インストール方法を見る

こんなときに便利

  • 新しいAPIを設計したいとき
  • モジュール間の契約を決めたいとき
  • 公開インターフェースの変更を検討するとき

日本語での紹介

できること

RESTやGraphQLのAPI、モジュール間の境界、コンポーネントのpropsなど、コード同士がやり取りする窓口の設計を支援します。実装に入る前に入力と出力の契約を決め、エラーの形式や命名をそろえ、外部入力を境界で検証する考え方を示します。リストAPIのページ分け、既存利用者を壊しにくい項目追加、型で表現する状態の分岐も扱います。再試行で二重処理が起きないようにする冪等性キーについては、キーの決め方、重複時の扱い、保存期間まで説明しています。

こんなときに便利

新しいAPIを設計するときや、チーム間の受け渡しを明確にしたいときに役立ちます。公開済みのインターフェースを変更する前に、利用側への影響や互換性を検討する場面にも向いています。

使い方の例

  • 「タスク管理APIの入力・出力とエラー形式を設計してください」
  • 「このREST APIにページ分けと部分更新を加える案を考えてください」
  • 「このインターフェース変更で既存利用者に影響する点を確認してください」

注意点

特定の実装やフレームワークに限定される記載はありません。

この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。

資料チェック

SKILL.md の記述から、注意が要る操作と導入の前提を AI が確認しました。点数は実際に動かした結果(実行検証)だけで付けています。

安全面送信・削除・コマンド実行などの扱いが明示されているか
A良好外部入力の境界検証と内部情報を漏らさないエラー方針を明記。
導入のしやすさ必要なツールや API キーが少ないか、書かれているか
A良好特定ツール、APIキー、OSなどの導入前提は記載されていない。

点数には入れていません。 2026年11月15日 時点で AI(OpenAI Codex)が判定しました。目安なので、入れる前に原文も確認してください。

評価が違うと思ったら、見直しを依頼する

どの項目が、なぜ違うと思うかを書いてください。ログインは不要です。内容を SKILL.md と照らし合わせて評価を作り直し、この欄に反映します。

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

含まれるファイル(1)

  • SKILL.md14.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

0codekit

無料概要あり

0codekitのワークスペースデータを扱うための連携スキルです。資料では表計算、タスク、文書、メール、カレンダー、データベースなどの情報を対象にしています。

  • 0codekitのワークスペース情報を扱いたいとき
  • 表やデータベースの情報を確認したいとき
  • タスクや予定を参照したいとき
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

0xarchive

無料概要あり

Hyperliquid、Lighter.xyz、HIP-3の暗号資産について、過去の価格やローソク足、注文板、取引、資金調達率、建玉などをAPIから調べ、データの鮮度や欠損も確認します。

  • 対応取引所の過去価格を調べたいとき
  • 注文板や取引履歴を確認したいとき
  • 資金調達率や建玉の推移を見たいとき
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

12-factor-apps

無料概要あり

コードベースを12-Factor Appの12原則に照らして調べ、設定や依存関係、ログなどの適合度と根拠、改善案をまとめます。

  • SaaSの構成を監査したいとき
  • クラウド移行の課題を洗い出すとき
  • コンテナ化の前に構成を点検するとき
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

13-Day Sprint Method

無料概要あり

マヤ暦に着想を得た13日周期で目標設定から実行、成果の振り返りまでを進め、個人やチームのプロジェクトに毎日の行動指針を設けます。

  • 個人のプロジェクトを13日で進めたいとき
  • チームのスプリントに日ごとの焦点を設けたいとき
  • 今日の行動指針を確認したいとき
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

13c-metabolic-flux

無料概要あり

炭素13の標識測定から細胞内の代謝反応速度を推定し、原子の対応関係や入力条件を点検して、測定データでどの経路の流量まで絞り込めるかを調べるスキル。

  • 炭素13の測定から代謝流量を推定したいとき
  • 原子対応表と測定入力の整合性確認
  • 仮定した反応速度から標識分布を予測
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

1688 Sourcing Agent

無料概要あり

1688.comで中国の仕入れ先や商品を選ぶため、出品者の確認、サンプル評価、価格交渉、配送方法の比較を段階的に支援します。輸入時の注意点や専門家に相談する目安も整理できます。

  • 1688.comの仕入れ先を確認したいとき
  • 予算に合う商品候補を絞りたいとき
  • 価格やサンプルを交渉したいとき
LeoYeAI/agent-master-skills2,1932026年11月1日 更新

LeoYeAI のスキルをすべて見る

このスキルの問題を報告する