| name | shipping-misskey-change |
| description | Use at every finish moment of a Misskey change, before committing, opening a PR, merging, or handing work back. Selects proportional validation, runs changed-file lint and repository safety checks, and records PASS/FAIL/BASELINE/SKIPPED without chasing unrelated failures. |
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. 変更別チェック
3. 引き継ぎ
実行項目を PASS / FAIL / BASELINE / SKIPPED で短く列挙する。
失敗時は今回の変更との関係、未実行時は理由を書く。
ユーザーが依頼していない commit / PR / 外部送信は行わない。