pleasant-ui-motion
既存デザインシステムのUIモーションを設計・実装・修正する。「押下に手応えを付けて」「保存結果を伝えて」「開閉を待たせないで」「連続選択を滑らかにして」「動きを減らして」に使う。new-yorkとcobaltの既存Token・APIを保ち、目的・状態・途中操作を先に決める。
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- pleasant-ui-motion
- description
- 既存デザインシステムのUIモーションを設計・実装・修正する。「押下に手応えを付けて」「保存結果を伝えて」「開閉を待たせないで」「連続選択を滑らかにして」「動きを減らして」に使う。new-yorkとcobaltの既存Token・APIを保ち、目的・状態・途中操作を先に決める。
02 资源文件 9
- 资产文件assets/profiles.json2.3 KB
- 资产文件assets/recipes.json1.5 KB
- 参考文档references/design-system.md3.6 KB
- 参考文档references/patterns.md4.7 KB
- 参考文档references/principles.md3.7 KB
- 参考文档references/rules.md16.0 KB
- 参考文档references/save-example.tsx965 B
- 参考文档references/sources.md4.3 KB
- 脚本scripts/motion.mjs9.3 KB
03 SKILL.md 正文
気持ち良いUIモーション
操作の認識、変化の理解、結果、操作の自由をつなぐ。「待たせない」は次の操作を演出完了で止めないこと。通常時の開閉アニメーションを消す意味にしない。遊び心は基本品質を満たした後に加える。判断基準とルールを使う。
この基盤内ではAGENTS.mdのコマンドと配置に従う。別のリポジトリへ導入した場合は、利用先のAGENTS.md・既存スキルを先に読み、仕様・検証用アプリ・設計履歴を禁止しているリポジトリへ追加しない。作業用仕様と検証は外部一時ディレクトリへ置ける。パスの <skill> はこのSKILL.mdのディレクトリを指す。
1. 依頼をパターンに振り分ける
| 依頼 | references/patterns.mdの節 |
|---|---|
| 押下、受理、手応え | 1 |
| 保存、通信、処理中、成功・失敗 | 2 |
| 選択、Tabs、並べ替え、段階移動 | 3 |
| 開閉、画面遷移、通知 | 4 |
| 実際のデザインシステムへ適用 | 5 |
複数なら上から該当分を扱う。表にない演出は、利用者の意図と既存部品から不要かを検討する。新エンジンを発明せず、既存recipeへ写せない理由と候補を報告する。
2. 依頼から決まらない値
| 値 | 影響 | 既定 |
|---|---|---|
| システム | Token・API | 既存導入を調査。両方/不明なら対象だけ確認 |
| id | 仕様の場所 | 指定の識別名。指定なしはrecipe名。既存idとの衝突時は上書きせず確認 |
| frequency | 反復の強さ | frequent |
| delight | 成功の装飾 | false |
| intent | 意味の評価 | 依頼の目的を1文で書く。目的を特定できなければ確認 |
| labels | 結果の伝達 | 指定文言をそのまま使用。指定なしはnewの既定から実UIに合わせる |
| 時間・曲線 | 一貫性 | 既存正本のToken。独自の80〜400msを上書きしない |
実装方式・既存値が調査で決まる事項は質問にしない。人間の業務判断が必要な点だけ確認する。
3. 書く前に読む
- patterns.mdの該当節と見本。
- design-system.md:new-york/cobaltの識別、正本、Portal・停止・propsの差。
- principles.md:目的と6原則。数値を規格化しない。
- rules.md:STR/DEP/NAM/CODE/ERRと該当するSTATE/ASYNC/MOT。
- 利用先の実ファイル・Story・配布定義。調査時点の参照先だけで現在の状態を断定しない。
4. 作る順序
- 対象の操作→受理→処理状態→結果と、次にできることを書き出す。状態を演出の完了から決めない。
- 本基盤の仕様追加なら
node <skill>/scripts/motion.mjs new ID SYSTEM RECIPEで始める。編集はmotion.jsonだけ。対象リポジトリに仕様を保存できない場合は外部一時ディレクトリで同じコマンドを使う。 - intent/frequency/delight/labelsを決め、
node <skill>/scripts/motion.mjs fmtとbuildを実行する。対象から決まらない文言の根拠は報告へ書く。 - 実UIの依頼なら既存部品の状態・Token・機構へ接続する。実UI手順を使い、仕様だけで完了にしない。
- 操作状態、静止時の寸法、名前付きexport、SVG、キーボード・フォーカスを維持する。
5. 検証する
仕様は作業用ディレクトリで node <skill>/scripts/motion.mjs check。本基盤では npm run check も実行する。型は閉じたJSON schemaで検査し、JSは構文検査と振る舞いテストで確認する。
実UIは利用先の型検査・lint・production buildに加え、連続操作、途中OFF、ON復帰、OS reduce、失敗・再試行、Portal、キーボード、スマホ幅を確認する。ブラウザーの低減設定エミュレーションを実機OS検証と混同しない。
失敗はルールIDから直す。設定緩和・抑止コメント・テスト削除で通さない(TOOL-02)。
6. 完了前チェックリスト
- [ ] STATE-01/MOT-01:実際の処理結果とラベル・状態通知が一致する。
- [ ] MOT-02:実コードが対象の正本Tokenを参照する。仕様の生成CSSは適用の代わりではない。
- [ ] ASYNC-01/MOT-03/MOT-05:開く・閉じる両方の中間状態、途中反転、演出中の別操作、停止・再開・フォーカスを実操作した。
- [ ] MOT-04/MOT-06:遊び心の頻度と対象の同一性を確認した。
- [ ] PROC-01:仕様と生成物、変更した正本と配布・Story・利用スキルを照合した。
- [ ] TEST-01/MOT-07:未観測の性能や快適さを断定していない。
7. 報告する
作ったもの、変更ファイル、採った既定値と理由、検証対象・コマンド・結果、未実施と人間の確認待ちの順で書く。コードの実際の記述と場所を示す。Issue投稿・公開は依頼された範囲だけ行う。
04 同仓库更多 Skills
setup
このDocusaurusパターンの初期設定・設定変更を、OSSと独自設定の台帳に沿った質問とCLIで行う。site.settings.jsonとsetup/settings.catalog.jsonがある配布先で使用する。
sample
日付の表記を ISO 8601(YYYY-MM-DD)にそろえる見本のスキル。テストで使う。
skill-tune
既存の Claude Code スキルを評価データで改善する。正解データがあれば学習用・検証用・テスト用に分け、無ければ人と評価項目を決め、独立した学習と検証のラウンドを回し、最後にテスト用で測って報告する。
review
skill-tune-kit の変更をレビューする手順。差分、プルリクエスト、ブランチ、特定のファイルのレビューを頼まれたとき、また「この実装で問題ないか確認して」「ルールに沿っているか見て」と頼まれたときは必ず使う。機械の検査を先に回し、機械で拾えないルールをルールIDごとに確かめ、固定の形式で指摘と判定を返す。
impl
skill-tune-kit で実装・変更・追加・修正を行う手順。「検査の種類を足して」「サブコマンドを追加して」「プロンプトの文言を直して」「plan.json に項目を足して」「status の表示を変えて」「採否の規則を変えて」「〜の不具合を直して」「skill-tune の手順を直して」などの依頼で使う。この基盤のコードや配布物を書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。
sample
議事録の日付をそろえる。議事録の整形を頼まれたときに使う。