misskey-dev shipping-misskey-change
Misskey の変更を commit / PR / merge する直前、または未commitでユーザーへ返す直前の出口。 規範は AGENTS.md、ここでは実行方法だけを定める。
1. 検証レベル
| 段 | 条件 | 実行 |
|---|---|---|
| 1 (必須) | package の ESLint 対象ファイルを変更 | 存在する変更ファイルへ eslint --quiet を最後に 1 回 |
| 2 | 実装・挙動を変更 | 最も近い unit test を実行。型・生成物・DB に関係するときは対応する専用検証も実行 |
| 3 (任意) | 明示依頼、広域変更、切り分けに必要 | package / repo 全体の lint、build、広域 test |
段 1 は docs-only など対象が空なら SKIPPED。
段 3 の既存失敗は成功扱いせず BASELINE として、今回の変更との関係だけを報告する。
自動検査
repo root で次を 1 回実行する。
node scripts/check-shipping.mjs
統合先を明示する場合は --base <ref>、または MISSKEY_BASE_REF を使う。
script は次を行い、独立した検査を最後まで続けて exit 0 (合格) / 1 (違反) / 2 (検査不能) に集約する。
- commit 済み・未commit・untracked の変更集合を NUL-safe に列挙し、変更ファイルだけへ package root から
eslint --quietを実行 - SPDX 違反時はローカル変更の欠落だけ
check-spdx.mjs --fixで補い、通常検査を再実行 - SPDX の結果にかかわらず、
locales/ja-JP.yml以外の locale YAML 変更を検査
SPDX: OK 後は追加確認しない。
その他の常設方針は AGENTS.md に従う。
2. 変更別チェック
- backend API の
meta/paramDef/res:pnpm build-misskey-js-with-types。 手順は regenerate-misskey-js.md - entity / migration:
pnpm --filter backend check-migrations。 新規 migration はup()/down()、既存のマージ済 migration は差分なし - backend API endpoint: misskey-api-reviewer を実行
- frontend
.vue: vue-component-reviewer を実行
3. 引き継ぎ
実行項目を PASS / FAIL / BASELINE / SKIPPED で短く列挙する。
失敗時は今回の変更との関係、未実行時は理由を書く。
ユーザーが依頼していない commit / PR / 外部送信は行わない。