working-on-frontend
packages/frontend/ (Misskey Web クライアント) を編集するとき、最初に参照するスキル。Vue 3 SFC / SCSS Modules / i18n / os.* / Storybook / アクセシビリティの 手順 と 背景知識 をまとめている。
SKILL.md 本体は references への索引だけ。具体的な手順や規約は該当ファイルを Read すること (progressive disclosure)。
他スキル実行後も免除されない。 brainstorming / writing-plans / その他アップストリームスキルを先に呼んでいても、packages/frontend/ に触れる実装フェーズに入る時点でこのスキルを呼ぶこと。
作業別ワークフロー (tasks)
タスク単位の完結したチェックリスト。新しい何かを足すときに開く。
- 新規 / 既存
Mk*Vue コンポーネントを追加・改修する → references/tasks/adding-mk-component.md - i18n キーを追加・改修する (
locales/ja-JP.yml編集) → references/tasks/adding-i18n-key.md
共通知識 (knowledge)
タスクに紐付かない参照リファレンス。SFC を 編集する 場面 (新規追加でなくても) で踏みうる規約。
<script setup>/ type-onlydefineProps/defineEmits/ generic SFC / v-model 連動など SFC 規約 → references/knowledge/component-conventions.mdi18n.ts.<key>/i18n.tsx.<key>(...)の使い分け / HTML タグ埋め込み / 動的キー切替 / 既存キーのリネーム手順 → references/knowledge/i18n-usage.md- SCSS Modules /
--MI_THEME-*--MI-*CSS 変数 / グローバル utility class (_button等) → references/knowledge/scss-modules.md os.alert/os.confirm/os.popup等 UI ヘルパー (ブラウザ標準alert()直呼びは禁止) → references/knowledge/os-api.md*.stories.impl.ts併設規則 + 複数 story / argTypes / layout / action パターン → references/knowledge/storybook.md- frontend Vitest / Playwright E2E の書き方と前提 → references/knowledge/frontend-testing.md
必ず最後に通る場所
frontend の変更を commit / PR にする前に、必ず shipping-misskey-change の最終チェックリストに従う。
.vue を追加・変更したなら、その出口で vue-component-reviewer agent (この skill の規約を review-mode から機械チェックする専門 reviewer) を Task で起動すると、命名・i18n・SCSS 変数・a11y・Storybook 併設の逸脱を取りこぼしにくい。