スキル allra-api-design
📦

allra-api-design

コンテンツリビジョン r2 安全 ⚙️ 外部コマンド

Allra 向け Spring REST API を設計する

バックエンドチームは、Spring API や DTO を追加するときに一貫性を失いがちです。このスキルは、パッケージ構成、REST 命名、DTO record、バリデーション、レスポンスに関する Allra の規約を適用します。

対応: Claude Codex Code(CC)
🥉 78 ブロンズ

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
Review the Skillstore skill "allra-api-design" from https://skillstore.io/skills/allra-fintech-allra-api-design.md and its manifest at https://skillstore.io/api/skills/allra-fintech-allra-api-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/allra-fintech-allra-api-design.md 署名済み manifest GET /api/skills/allra-fintech-allra-api-design/manifest 署名済み lockfile GET /api/skills/allra-fintech-allra-api-design/lockfile

テストする

「allra-api-design」を使用しています。 Allra バックエンドサービス用の商品作成 API を作成してください。

期待される結果:

  • 結果では商品ドメインのパッケージ名を示し、API、DTO、entity、repository、service レイヤーを分離します。
  • 公開 DTO 名として CreateProductRequest と ProductResponse を提案します。
  • 商品名と価格フィールドに必要なバリデーションを推奨します。

「allra-api-design」を使用しています。 Allra 標準に照らして、私のユーザー API 構成をレビューしてください。

期待される結果:

  • レビューでは、controller、DTO、repository、service の責務を分離していないパッケージ名を指摘します。
  • Request、Response、Dto suffix を使用すべき DTO を特定します。
  • リクエスト DTO にバリデーションルールが含まれているかを確認します。

「allra-api-design」を使用しています。 商品クエリ結果とイベント用の内部 DTO を計画してください。

期待される結果:

  • 計画では、クライアント向け DTO と内部転送オブジェクトを区別します。
  • 内部クエリオブジェクトとイベントオブジェクトには Dto suffix を推奨します。
  • QueryDSL projection DTO が適している可能性がある箇所を示します。

セキュリティ監査

安全
v9 • 2026/7/23 バージョン別レポートを開く

All 31 static findings are false positives caused by Markdown backticks, fenced examples, and ordinary Java request parameters. The skill is a documentation-only API design guide with no command execution, system reconnaissance, or prompt injection behavior.

1
スキャンされたファイル
269
解析済み行数
0
レビュー項目
0
誤検知を無視

リスク要因

⚙️ 外部コマンド (26)
SKILL.md:24-32 SKILL.md:32-34 SKILL.md:34 SKILL.md:38-55 SKILL.md:55-61 SKILL.md:61-62 SKILL.md:62 SKILL.md:63-64 SKILL.md:64 SKILL.md:68-71 SKILL.md:71 SKILL.md:77-96 SKILL.md:96-102 SKILL.md:102-137 SKILL.md:137-139 SKILL.md:139-145 SKILL.md:145-158 SKILL.md:158-165 SKILL.md:165-170 SKILL.md:170-173 SKILL.md:173-181 SKILL.md:181-199 SKILL.md:199-236 SKILL.md:236-240 SKILL.md:240-257 SKILL.md:257-268
最新の完了済み静的・セマンティック監査では、確認済みのセキュリティ検出事項は見つかりませんでした。これは、スキルに副作用がないことを証明するものではありません。
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdownバッジ

[![Skillstore security assessment](https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg)](https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge)

HTMLバッジ

<a href="https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/allra-fintech-allra-api-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学術引用 (APA · BibTeX · CFF)

APA形式の引用

Allra-Fintech. (2026). allra-api-design security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9

BibTeX形式の引用

@techreport{allra-fintech-allra-fintech-allra-api-design-2026, author = {Allra-Fintech}, title = {allra-api-design security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "allra-api-design security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "Allra-Fintech" date-released: "2026-07-23" url: "https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9" identifiers: - type: other value: "skillstore:allra-fintech-allra-api-design:audit:9" description: "Skillstore immutable audit report identifier"

Skillstore スコア

このスコアの理由 証拠の信頼度: 高
55
アーキテクチャ
85
保守性
87
コンテンツ
70
コミュニティ
83
仕様準拠

作成できるもの

新しいドメイン API を作成する

新しいバックエンドドメイン向けに、一貫したパッケージ計画、DTO 名、コントローラールート、バリデーションチェックリストを生成します。

API の一貫性をレビューする

pull request がマージされる前に、既存のコントローラーと DTO の設計を Allra の規約と比較します。

AI 支援によるバックエンド作業をガイドする

実装タスク中に、Claude、Codex、Claude Code を Allra のバックエンド標準に沿わせます。

これらのプロンプトを試す

DTO 計画を作成する 
Allra の規約を使用して、新しいユーザー登録 API のリクエスト DTO とレスポンス DTO を設計してください。フィールドバリデーションの推奨事項も含めてください。
REST エンドポイントを設計する 
商品を作成するための Allra スタイルの Spring REST エンドポイントを設計してください。ルート命名、パッケージ配置、DTO 名、レスポンスガイダンスを含めてください。
パッケージ構成をリファクタリングする 
このバックエンドモジュール構成をレビューし、Allra のドメインパッケージルールとレイヤー責務に沿う変更を提案してください。
マージ前に API 設計を監査する 
この Spring API 設計を Allra 標準に照らして監査してください。パッケージ構成、REST 命名、DTO suffix、record 使用、バリデーション、レスポンスの一貫性を確認してください。

ベストプラクティス

  • 設計を依頼する前に、対象ドメイン、エンドポイントの目的、既存のパッケージ名を提供してください。
  • リクエスト DTO がクライアント入力を受け取る場合は、必ずバリデーションルールを依頼してください。
  • 生成された設計を、プロジェクト固有の API バージョニングとレスポンスポリシーに照らしてレビューしてください。

回避

  • controller、service、repository、entity クラスを 1 つのパッケージに混在させないでください。
  • 公開リクエストオブジェクトやレスポンスオブジェクトに Dto suffix を使用しないでください。
  • プロジェクト標準を確認せずにサンプルのレスポンス形状をコピーしないでください。

よくある質問

このスキルは何の設計を支援しますか？
Allra バックエンド向けに、Spring REST API、DTO 名、バリデーションルール、レスポンス形状、ドメインパッケージ構成の設計を支援します。
本番環境で使えるコードを生成しますか？
設計ガイダンスと例を提供します。本番コードには、引き続きプロジェクトのコンテキスト、テスト、認可、永続化の詳細が必要です。
DTO にはどの Java スタイルを優先しますか？
プロジェクトが対応している場合、単純なリクエスト、レスポンス、内部転送オブジェクトには Java record を優先します。
Allra プロジェクト以外でも使用できますか？
はい。ただし、規約は Allra 固有です。他のチームは、名前、ルート、レスポンス形式を自分たちの標準に合わせて調整する必要があります。
API セキュリティも扱いますか？
基本的なバリデーションガイダンスのみ含まれます。認証、認可、レート制限、機密データの取り扱いには別途レビューが必要です。
どの AI ツールで使用できますか？
レポートには Claude、Codex、Claude Code のサポートが記載されています。

開発者情報

作成者

Allra-Fintech

ライセンス

MIT

Skillstore リビジョン

r2

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/api-design

参照

31bc7611b504c197d3e993aef7943461c871616f

メンテナンスの新しさ

2026/7/26

利用状況

10 ダウンロード · 233 閲覧

ファイル構成

📄 SKILL.md

Allra-Fintech のその他のスキル

すべて表示

関連スキル

すべて表示