Communitygithub.com

alty-oss/dev-design

UI変更の成果を納品する際に、決定事項、検証証拠、残存制限事項とともに報告するために使用します。

dev-design とは?

このスキルは、UI変更を完了した際に、その変更の決定事項、検証証拠、および残存する制限事項を明確に文書化し、開発者やレビュアーに効率的に引き継ぐためのテンプレートとガイドラインを提供します。主にClaude CodeなどのAIエージェントが設計変更の成果を報告する際に利用することを想定しており、証拠ファイルの管理方法(履歴の保存、旧リビジョンの変更禁止、スキーマバージョンの固定)や、報告すべき情報(変更内容、影響範囲、テスト手順、未解決の課題)が細かく定義されています。また、自動生成ファイルや単体テストの合格だけを「完了」とみなさないよう注意を促し、常に人間による品質レビューを前提とした厳格なワークフローを推奨します。このスキルに従うことで、変更のトレーサビリティが向上し、後続の開発者やテスターが迷うことなく作業を継続できるようになります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alty-oss/dev-design/tree/HEAD/skills/design-handoff

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デザインハンドオフ

Português (Brasil)

アーティファクト契約を使用します。証拠が現在のコードリビジョンを参照していることを確認してください。視覚的変更の後は、過去の生キャプチャ/ハッシュと変更されていないリビジョン固有の証拠ファイルを保存し、現在のノート/レビューで陳腐化を注釈し、影響を受ける現在のチェックを再観測まで「pending」に設定します。schemaVersion は 1 のまま、passed|failed|pending のステータスを使用します。キャプチャのタイムスタンプを捏造したり、古いリビジョンのメタデータを書き換えたりしないでください。

何が変更されたのか、その理由、影響を受ける画面、実行方法/レビュー方法、決定事項、証拠、実際に完了したチェックと未完了のチェックまたは欠陥を要約します。

生成ファイル、ビルドパス、スクリーンショット、またはスコアを完全なプロフェッショナル品質と同一視しないでください。

ブロッカーが残っている場合は、その影響と次のアクションを報告し、結果を完全に検証済みと見なさないでください。

ユーザー向けの要約は簡潔に保ち、レビュー/証拠ファイルへのリンクを含めます。暗黙の納品ステップとして公開、デプロイ、メッセージの送信、インテグレーションのインストールを行わないでください。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル