merge: Misskey公式develop 2026.8.0-alpha.0を取り込み

.agents/skills/shipping-misskey-change/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: shipping-misskey-change
-description: Use at every finish moment of a Misskey change, before committing, opening a PR, merging, or handing work back, especially when validation, SPDX, locale safety, migrations, misskey-js generation, or CHANGELOG checks may apply.
+description: Use at every finish moment of a Misskey change, before committing, opening a PR, merging, or handing work back, especially when proportional validation, SPDX, locale safety, migrations, or misskey-js generation may apply.
 ---
 
 # shipping-misskey-change

.claude/THIRD_PARTY_LICENSES.md

@@ -18,8 +18,8 @@
 | `.claude/` 内のパス | 上流パス | 上流由来 | Misskey での改変 |
 |---|---|---|---|
 | `skills/context-budget/SKILL.md` | `skills/context-budget/SKILL.md` | ECC | description を日本語化、Misskey 固有メモを追記 |
-| `commands/harness-audit.md` | `commands/harness-audit.md` | ECC | scripts 依存の自動採点を、Claude が `pnpm`/`git`/`grep` で手動採点する版に書き換え。Misskey 固有の評価軸 (SPDX / endpoint-list / migration / locales) を組み込み |
-| `commands/quality-gate.md` | `commands/quality-gate.md` | ECC | 言語自動判定を排除し Misskey 固定 pipeline (`pnpm` + tsgo + ESLint + Vitest) に。Prettier/Biome フェーズを削除 |
+| `commands/harness-audit.md` | `commands/harness-audit.md` | ECC | scripts 依存の自動採点を、repository-native command と SPDX checker で採点する版に書き換え。Misskey 固有の評価軸 (SPDX / endpoint-list / migration / locales) を組み込み |
+| `commands/quality-gate.md` | `commands/quality-gate.md` | ECC | 言語自動判定を排除し Misskey 固定 pipeline (`pnpm` + tsc + ESLint + Vitest) に。Prettier/Biome フェーズを削除 |
 
 ### MIT License (full text)
 

.claude/agents/README.md

@@ -10,7 +10,8 @@ frontmatter (`name` + `description` + `tools`) は、Claude が **自動でエ
 
 レビュー面を増やしすぎないよう、役割を分ける:
 
-- **この `.claude/agents/` の 2 つ**: backend endpoint / Vue SFC の **Misskey 固有・機械的チェック** (endpoint-list 登録漏れ・misskey-js 再生成漏れ・ja-JP.yml 限定・SPDX 形式・Storybook 併設 等)。別コンテキストで差分を機械走査する価値がある領域に限定する
+- **この `.claude/agents/` の 2 つ**: backend endpoint / Vue SFC の **Misskey 固有・機械的チェック** (endpoint-list 登録漏れ・misskey-js 再生成漏れ・ja-JP.yml 限定・Storybook 併設 等)。
+  別コンテキストで差分を機械走査する価値がある領域に限定する
 - **`pr-review-toolkit` プラグイン (code-reviewer / silent-failure-hunter 等)**: 言語非依存の一般的なコード品質・バグ・設計レビュー。Misskey 固有規約は見ない
 - **`working-on-*` skill の checklist**: コードを **書いている最中** の自己チェック (レビュー専用ではなく実装ガイド)
 

.claude/agents/misskey-api-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: misskey-api-reviewer
-description: Misskey backend の REST API エンドポイント (packages/backend/src/server/api/endpoints/) 追加・変更を機械レビューする。endpoint-list 登録漏れ・misskey-js 再生成漏れ・meta/paramDef/UUID/SPDX を検査。backend API を変更した PR レビューで呼ぶ。
+description: Misskey backend の REST API エンドポイント (packages/backend/src/server/api/endpoints/) 追加・変更を機械レビューする。endpoint-list 登録漏れ・misskey-js 再生成漏れ・meta/paramDef/UUID を検査。backend API を変更した PR レビューで呼ぶ。
 tools: Read, Grep, Glob, Bash
 ---
 
@@ -30,26 +30,12 @@ BASE=$(git merge-base origin/develop HEAD)
 - `packages/backend/src/server/api/endpoint-list.ts`
 - `packages/backend/test/e2e/**` (とくに `endpoints.ts` と `<area>.ts`)
 - `packages/misskey-js/src/autogen/**`
-- `CHANGELOG.md`
 
 差分対象が空なら「レビュー対象の API エンドポイント変更なし」と短く報告して終了。
 
 ## チェックリスト
 
-### 1. SPDX ヘッダー (Critical)
-
-新規 `.ts` ファイル冒頭に以下があるか:
-
-```
-/*
- * SPDX-FileCopyrightText: syuilo and misskey-project
- * SPDX-License-Identifier: AGPL-3.0-only
- */
-```
-
-欠落すると CI の `spdx` ジョブが落ちる。
-
-### 2. `meta` の必須・推奨フィールド (Major)
+### 1. `meta` の必須・推奨フィールド (Major)
 
 [endpoints.ts の型定義](../../packages/backend/src/server/api/endpoints.ts) を真とする。
 
@@ -63,7 +49,7 @@ BASE=$(git merge-base origin/develop HEAD)
 - `res`: JSON Schema または `ref: '<EntityName>'`。各プロパティに `optional` / `nullable` が **明示** されているか。
 - `requireFile` / `secure` / `allowGet` / `cacheSec` / `description`: 該当するエンドポイントで使い分けているか。
 
-### 3. `meta.errors` の UUID 検証 (Critical)
+### 2. `meta.errors` の UUID 検証 (Critical)
 
 各 `errors[*].id` が:
 
@@ -78,14 +64,14 @@ grep -rn "id: '<生成された UUID>'" packages/backend/src/server/api/endpoint
 
 新規エンドポイントの全 `id` を抽出して衝突を確認する。
 
-### 4. `paramDef` (Major)
+### 3. `paramDef` (Major)
 
 - JSON Schema 形式 (`type: 'object'`, `properties`, `required`)
 - ID 文字列は `format: 'misskey:id'`
 - `required` 配列で必須プロパティを明示
 - `as const` または `as const satisfies Schema` で型推論を効かせる (既存実装は前者多数。`as const` 自体が無く `Schema` 型注釈もない場合のみ指摘)
 
-### 5. エンドポイント実装本体 (Major)
+### 4. エンドポイント実装本体 (Major)
 
 - `Endpoint<typeof meta, typeof paramDef>` を継承しているか。
 - `@Injectable()` デコレータ + `export default class` 形式か (`// eslint-disable-line import/no-default-export` が必要)。
@@ -94,7 +80,7 @@ grep -rn "id: '<生成された UUID>'" packages/backend/src/server/api/endpoint
 - 防御的アサーション・「起きるはずがない」内部不整合・テスト用 ENV ガード等の **想定外フェイルファスト** は `throw new Error('...')` で構わない。既存実装でも `admin/reset-password.ts` などが採用しているパターン (例: `cannot reset password of root`)。`meta.errors` に対応がない `throw new Error` を一律で指摘しない。
 - 同期 `throw` は許容。非同期処理での例外伝搬を確認する。
 
-### 6. ★ `endpoint-list.ts` への登録 (Critical)
+### 5. ★ `endpoint-list.ts` への登録 (Critical)
 
 最も忘れやすい。**忘れると 404**。[endpoint-list.ts](../../packages/backend/src/server/api/endpoint-list.ts) に 1 行追加されているか:
 
@@ -110,7 +96,7 @@ grep -F "'<category>/<name>'" packages/backend/src/server/api/endpoint-list.ts
 
 **並び順の補足**: ファイル全体は厳密なアルファベット順では並んでおらず、同カテゴリ内 (`admin/queue/*` など) でも追加された経緯どおりの順になっている箇所が多い。**順序逸脱は指摘根拠にしない** (誤検知の元)。「行が存在するか」のみを Critical 観点として扱う。
 
-### 7. `misskey-js` 再生成 (Critical)
+### 6. `misskey-js` 再生成 (Critical)
 
 `meta` / `paramDef` / `res` を変更したら、PR / ブランチに `packages/misskey-js/src/autogen/` 配下の差分が含まれているか確認する:
 
@@ -121,22 +107,12 @@ git diff --name-only "$BASE"...HEAD -- packages/misskey-js/src/autogen/
 
 差分ゼロなら `pnpm build-misskey-js-with-types` の実行漏れ。CI の `check-misskey-js-autogen` ワークフローで必ず落ちるため Critical 扱い。
 
-### 8. e2e テスト (Major)
+### 7. e2e テスト (Major)
 
 [test/e2e/endpoints.ts](../../packages/backend/test/e2e/endpoints.ts) または `test/e2e/<area>.ts` (`note.ts`, `users.ts` 等) 配下に、対応する `api('<category>/<name>', ...)` 呼び出しを含む `test(...)` ケースが追加されているか確認する。複雑な分岐 (権限チェック・エラーケース) の網羅も確認する。
 
 **describe ラベルの形式は問わない**: 既存テストは `describe('Note', () => { test('投稿できる', ...) })` のように人間可読ラベルで構造化されており、`<category>/<name>` 形式の describe は使われていない。describe 名の規約違反としては指摘しない。
 
-### 9. CHANGELOG エントリ (Minor)
-
-ユーザー影響がある (新エンドポイント / 既存挙動変更) 場合、`CHANGELOG.md` の `## Unreleased` → `### Server` に 1 行追加されているか確認する。
-
-```
-- Feat: /api/<category>/<name> を追加
-```
-
-純粋な内部リファクタなら不要。
-
 ## 出力形式
 
 優先度別に以下のフォーマットで出力する。
@@ -166,4 +142,4 @@ git diff --name-only "$BASE"...HEAD -- packages/misskey-js/src/autogen/
 - [endpoint-base.ts (Endpoint 基底クラス)](../../packages/backend/src/server/api/endpoint-base.ts)
 - [error.ts (ApiError)](../../packages/backend/src/server/api/error.ts)
 - [test/e2e/endpoints.ts](../../packages/backend/test/e2e/endpoints.ts)
-- [AGENTS.md](../../AGENTS.md) — SPDX / マイグレーション履歴 / CHANGELOG 書式などの最低限ルール (Codex / Copilot と共通)
+- [AGENTS.md](../../AGENTS.md) — 共通の安全規約と検証方針

.claude/agents/vue-component-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: vue-component-reviewer
-description: Misskey frontend の Vue 3 SFC (packages/frontend/src/components/ / pages/ の *.vue) 変更を機械レビューする。SPDX (HTML コメント)・Mk* 命名・i18n.ts/tsx・SCSS 変数・os.* 経由・a11y・Storybook 併設 (*.stories.impl.ts) を検査。frontend の .vue を変更した PR レビューで呼ぶ。
+description: Misskey frontend の Vue 3 SFC (packages/frontend/src/components/ / pages/ の *.vue) 変更を機械レビューする。Mk* 命名・i18n.ts/tsx・SCSS 変数・os.* 経由・a11y・Storybook 併設 (*.stories.impl.ts) を検査。frontend の .vue を変更した PR レビューで呼ぶ。
 tools: Read, Grep, Glob, Bash
 ---
 
@@ -29,40 +29,26 @@ BASE=$(git merge-base origin/develop HEAD)
 
 - `locales/*.yml` (とくに `ja-JP.yml` 以外の変更は即 Critical)
 - `packages/frontend/src/components/**/*.stories.impl.ts`
-- `CHANGELOG.md`
 
 差分対象が空なら「レビュー対象の Vue コンポーネント変更なし」と短く報告して終了。
 
 ## チェックリスト
 
-### 1. SPDX ヘッダー (Critical)
-
-`.vue` ファイル冒頭は **HTML コメント形式** で必須:
-
-```html
-<!--
-SPDX-FileCopyrightText: syuilo and misskey-project
-SPDX-License-Identifier: AGPL-3.0-only
--->
-```
-
-`/* ... */` (TS 形式) は禁止 (CI の `spdx` ジョブはコメント形式ではなく SPDX 文字列の有無のみを検査するため、形式が違っても CI は通るが、規約違反として指摘する)。形式の根拠は references/knowledge 側を参照。
-
-### 2. 命名規約 (Major)
+### 1. 命名規約 (Major)
 
 - 共有 / 再利用コンポーネント (`packages/frontend/src/components/` 配下、サブディレクトリ含む) は `Mk` プレフィックス必須 (例: `MkButton.vue`, `global/MkAvatar.vue`, `grid/MkGrid.vue`)。
 - ページ固有のものは `pages/` 配下に置き、`Mk` プレフィックスは不要。
 
 **補足:** `<script setup>` SFC は named export を持たないため、「ファイル名と export 名の一致」を機械的に検査することはできない。SFC のデフォルトエクスポートはコンパイラ生成なので、ファイル名規約のみを基準にする。
 
-### 3. `<script>` タグ (Major)
+### 2. `<script>` タグ (Major)
 
 - `<script lang="ts" setup>` または `<script setup lang="ts">` のどちらでもよい (既存コードは多数派が前者だが、後者も `MkThemePreview.vue` 等で使われている)。属性順は指摘しない。`lang="ts"` が **無い** ものは指摘する。
 - 型ジェネリックが必要なら `generic="T extends ..."` 属性を加える (順序問わず)。
 - `defineProps<{ ... }>()` / `defineEmits<{ ... }>()` は **type-only** 形式。runtime の object 形式 (`defineProps({ ... })`) は使わない。
 - Options API (`export default { data() { ... } }`) は禁止。
 
-### 4. i18n の使い分け (Critical)
+### 3. i18n の使い分け (Critical)
 
 - 文字列リテラルの直書き禁止 (テンプレート / JS 両方)。
 - 引数なし: `i18n.ts.<path>` (例: `i18n.ts.deleted`)。
@@ -77,7 +63,7 @@ BASE=$(git merge-base origin/develop HEAD)
 git diff --name-only "$BASE"...HEAD -- 'locales/*.yml' | grep -v 'ja-JP.yml'
 ```
 
-### 5. スタイル (Major)
+### 4. スタイル (Major)
 
 - `<style lang="scss" module>` を既定とし、`:class="$style.foo"` で参照する。
 - 新規で `<style scoped>` (module なし) は使わない (legacy)。
@@ -94,7 +80,7 @@ git diff "$BASE"...HEAD -- 'packages/frontend/src/**/*.vue' \
   | grep -E '^\+' | grep -E '#[0-9a-fA-F]{3,8}\b|rgba?\('
 ```
 
-### 6. UI 操作は `os.*` 経由 (Critical)
+### 5. UI 操作は `os.*` 経由 (Critical)
 
 - 直接の `alert()` / `confirm()` / `window.prompt()` / `window.alert()` は禁止。
 - `os.alert` / `os.confirm` / `os.popup` / `os.toast` / `os.popupMenu` / `os.contextMenu` / `os.form` / `os.apiWithDialog` を使う ([os.ts](../../packages/frontend/src/os.ts) 参照)。
@@ -107,14 +93,14 @@ git diff "$BASE"...HEAD -- 'packages/frontend/src/**/*.vue' \
   | grep -E '^\+' | grep -E '\b(alert|confirm|prompt)\s*\('
 ```
 
-### 7. アクセシビリティ (Major)
+### 6. アクセシビリティ (Major)
 
 - クリック可能要素は `<button>` か、`role="button"` + `tabindex="0"` + キーボードハンドラ (`@keydown.enter` 等) を実装する。
 - 装飾以外の `<div @click>` で a11y 配慮がないものは指摘する。
 - フォーム要素には対応する `<label>` または `aria-label` を付ける。
 - `:disabled` バインドや `aria-disabled` の整合性を確認する。
 
-### 8. Storybook 併設 (Major)
+### 7. Storybook 併設 (Major)
 
 - 共有 `Mk*` コンポーネントを新規追加した場合、`Mk<Name>.stories.impl.ts` が同階層に併設されているか (サブディレクトリ含む。例: `components/global/MkAvatar.stories.impl.ts`, `components/grid/MkGrid.stories.impl.ts`)。
 - **ファイル名は `.stories.impl.ts` 固定** (`.stories.ts` は生成物なので手編集・コミット不可)。
@@ -130,31 +116,20 @@ git diff --name-only --diff-filter=A "$BASE"...HEAD -- \
   | xargs -I {} sh -c 'test -f {} || echo "missing: {}"'
 ```
 
-### 9. アイコン (Minor)
+### 8. アイコン (Minor)
 
 - アイコンは Tabler icons クラス (`<i class="ti ti-info-circle">` 等) を使う。
 - インライン SVG や別アイコンセットは原則使わない (既存パターンに合わせる)。
 
-### 10. CHANGELOG エントリ (Minor)
-
-ユーザー影響がある変更なら、`CHANGELOG.md` の `## Unreleased` → `### Client` に 1 行追加されているか確認する。
-
-```
-- Enhance: <component> の <挙動> を改善
-- Fix: <component> の <不具合> を修正
-```
-
-純粋な内部リファクタなら不要。
-
 ## 出力形式
 
 優先度別に以下のフォーマットで出力する。
 
 ```
 ## 🔴 Critical
-- packages/frontend/src/components/MkFoo.vue:1
-  SPDX ヘッダーが HTML コメント形式ではなく TS 形式になっている。
-  `<!-- ... -->` で書き直すこと。
+- packages/frontend/src/components/MkFoo.vue:42
+  ブラウザ組み込みの `alert()` を直接呼んでいる。
+  `os.alert()` を使用すること。
 
 ## 🟡 Major
 - ...
@@ -175,4 +150,4 @@ git diff --name-only --diff-filter=A "$BASE"...HEAD -- \
 - [MkButton.vue](../../packages/frontend/src/components/MkButton.vue)
 - [MkInput.vue](../../packages/frontend/src/components/MkInput.vue) — generic SFC 例
 - [MkButton.stories.impl.ts](../../packages/frontend/src/components/MkButton.stories.impl.ts) — Storybook 雛形
-- [AGENTS.md](../../AGENTS.md) — SPDX / locales 編集制限 / CHANGELOG 書式などの最低限ルール (Codex / Copilot と共通)
+- [AGENTS.md](../../AGENTS.md) — 共通の安全規約と検証方針