القائمة
detect-images の応答形・エラーコード・HTTP ステータス・エラー優先順位・部分成功不変条件に後方互換を壊す変更が無いかを検査する。PR 前や API 周辺を変更した後に使う。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/misskey-dev/sensitive-detector --skill api-contract-guardيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
onnxruntime-node / Node / Docker ベースイメージなどネイティブ ML スタック依存を上げる前に、glibc・Docker runtime の Node22 との整合を確認する。依存のバージョンを上げる時に使う。
PR・コミット前に CI 相当のローカル関門（typecheck / lint / unit / integration / docker build）を順に通し、落ちた所だけ報告する。CI が未整備の間の関門であり、のちの CI 仕様でもある。
sensitive-detector に機能を足す時の判断軸と、生予測値サービスとしての不変条件。コードを書く・レビューする・新機能を検討する時に常に適用する。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | api-contract-guard |
| description | detect-images の応答形・エラーコード・HTTP ステータス・エラー優先順位・部分成功不変条件に後方互換を壊す変更が無いかを検査する。PR 前や API 周辺を変更した後に使う。 |
| disable-model-invocation | true |
| context | fork |
| allowed-tools | Read, Grep, Glob, Bash |
このサービスの応答は Misskey 本体の judgePrediction（FileInfoService.ts の
find(x => x.className === 'Sexy' / 'Porn')）が直接参照する。形・コード・ステータス・
部分成功の挙動を壊すと本体が無言で誤動作する。 現在の差分を正本と突き合わせ、破壊的変更を洗い出す。
エンドポイントは POST /v1/detect-images（multipart/form-data・バッチ） の 1 本。
複数の正規化済み画像を一括推論し、各パーツの生予測値を順序保持で返す。
git diff --name-only main...HEADgit diff main...HEAD -- apps/server/src packages/core/src README.mdpackages/core/src/types.ts
Prediction = { className:string; probability:number }（ONNX Runtime 生出力・確率降順。
PredictionType を re-export しつつ className を string に緩めた契約）。BatchItemResult = { success:true; predictions: Prediction[] }
｜ { success:false; error:{ code:DetectErrorCode; message:string } }（パーツ単位の結果）。DetectImageSuccessResult / DetectFailedResult は core 内部の単一推論型（detectImage）であり、
HTTP 応答の形ではない点に注意。apps/server/src/routes/detect-images.ts / app.ts）:
{ success:true, result:{ results: BatchItemResult[] } }。
results の順序はリクエストパーツ順と一致する。{ success:false, error:{ code, message } }。DetectErrorCode（7 種）と HTTP ステータス表 STATUS_BY_CODE
（apps/server/src/lib/error-mapping.ts）。7 種 =
AUTHENTICATION_REQUIRED(401) / INVALID_REQUEST(400) / UNSUPPORTED_MEDIA_TYPE(415) /
REQUEST_TOO_LARGE(413) / IMAGE_DECODE_FAILED(422) / MODEL_UNAVAILABLE(503) /
DETECTION_FAILED(500)。app.ts のミドルウェア順 ＋ detect-images.ts）:
認証(401) → bodyLimit 超過 413(maxBodySize) → 非 multipart 415 →
multipart パース失敗 400 → パーツ 0 件 400 → パーツ数超過 413(maxParts)。detect-images.ts 内、各パーツ毎・全体は 200 のまま results[i].error に格納）:
非 File 400 → 非対応 part Content-Type 415 → 空ボディ 400 → サイズ超過 413(maxBinarySize) →
dimensions 読取失敗 422(IMAGE_DECODE_FAILED) → dimensions 上限超過 413
(maxImageWidth/maxImageHeight/maxImagePixels) → 推論。image/png|jpeg|gif|bmp
（detect-images.ts の ACCEPTED_CONTENT_TYPES）。リクエスト全体は multipart/form-data。README.md の API 表。result.results[] 構造の変更・BatchItemResult のキー改名・predictions の形変更・
確率降順保証の喪失。results の順序保証の喪失、
パーツ失敗を 200 以外で返す。DetectErrorCode の削除・改名、STATUS_BY_CODE のステータス変更。success フラグの廃止・意味変更、error.code 以外での分岐を強要する変更。各論点を ✅(影響なし) / ⚠️(要確認) / ❌(後方互換破壊) で列挙し、❌ は 「どのファイルのどの変更が・本体の何を壊すか・どう直すか」まで一行で示す。 新規エンドポイントの追加など既存契約を変えない拡張は ✅（scope-guard の判断軸に従う）。