Communitygithub.com

ulasalyesil/personal-website-v2

観察された行動レイヤーでのユーザーリサーチ計画と統合 — 信頼度付きのジョブストーリー候補を生成します。

personal-website-v2 とは?

このスキルは、ユーザーリサーチの計画(Planモード)と既存データの統合(Synthesiseモード)を支援し、観察された行動から信頼性のあるジョブストーリーを生成します。ユーザーが実際に行ったこと(生データ)に基づき、JTBDインタビュー、文脈的観察、日記調査、サポートチケット分析、アナリティクスレビューなどの手法を適切に選択・実行するためのガイドを提供します。特に、観察・推測・仮定という3段階の信頼度を明示することで、チームの思い込みではなく証拠に基づいた意思決定を促進します。Claude CodeやCursorなどのAIエージェントプラットフォーム上で動作し、リサーチギャップを明確にし、次の「ユーザーニーズレイヤー」への橋渡しを行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-observed-behaviour

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

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

ドキュメント

/layers-observed-behaviour

前提: /layers-intro がフレームワークのコンテキストとして読み込まれていること。

観察された行動レイヤーは、現実に最も近い層です。これは生の素材です — ユーザーが実際に行うことであり、私たちが彼らが行っていると思っていることや、行ってほしいと願うことではありません。その上のすべては解釈です。この層が出発点です。

この層が下すべき判断:

  • ユーザーについて最も答える必要がある具体的な質問は何か?
  • どのような証拠がすでに存在し、その信頼性はどの程度か?
  • 不足しているものをどのように収集するか?
  • どのようなパターンが現れるか — そして、何を確信を持って主張でき、何が仮定のまま残るか?

手法:

手法いつ使用するか
JTBDインタビュートリガー、動機、不安を理解する。仮定の話ではなく、実際の過去の経験についてインタビューする。
文脈的調査 / 観察ユーザーの発言と行動が異なる場合。実際の作業を観察することで、暗黙の行動が明らかになる。
日記調査行動が時間的に分散している、または頻度が低い場合 — ユーザーがイベント発生時に自己報告する。
サポートチケット / レビュー分析シグナルが蓄積された既存の製品がある場合。リクルートなしで大規模なペインポイントを特定するのに適している。
アナリティクスレビューユーザーが何をしているか(理由ではない)。定性調査を補完するものであり、代替するものではない。
ユーザビリティ観察既存製品でユーザーがどこで苦労し、どこで成功するか?

品質シグナル — 良い状態の指標:

  • 観察結果は具体的で生データに近く、結論に要約されていない
  • ジョブストーリーは、見たり聞いたりしたことに基づいており、チームの信念から推測されたものではない
  • 信頼度が明記されている: 観測 / 推測 / 仮定
  • リサーチギャップは明示的に名前が挙げられ、隠蔽されていない
  • 回避策がフラグ付けされている — 即興を動機付けるほど現実的なニーズは強力なシグナルである

このスキルは2つのモードで動作します。どちらが該当するかを検出し、明確に述べてください:

  • Planモード — リサーチがまだない場合; 調査計画の設計を支援する
  • Synthesiseモード — 既存のリサーチ資料がある場合; それを理解するのを支援する

部分的なリサーチがある場合は、既存のものでSynthesiseモードから開始し、ギャップを特定するためにPlanモードに移行します。


ガイド付きセッション

現在取り組んでいること、ユーザーについて最も答える必要がある質問を教えてください — または「plan」または「synthesise」と入力してガイド付きセッションを開始してください。

質問: "このセッションの成果をどこに保存すればよいですか?"(選択肢については/layers-introを参照)

質問: "既存のリサーチ(インタビュー、セッション録画、サポートチケット、アナリティクス)はありますか?それともゼロからリサーチを計画する必要がありますか?" 明確になったらモードを述べてください。


Planモード

フェーズ1 — 学習目標を定義する

デザイナーが最も理解する必要があることを明確にするのを支援します。曖昧な目標を超えて進めます:

  • 「ユーザーをよりよく理解する」ではなく、「誰かが友人を紹介するきっかけとなるものと、ためらわせるものを理解する」

2〜3つの具体的なリサーチクエスチョンを書き出します。

フェーズ2 — 参加者を特定する

観察する必要のある行動を持つのは誰か?前提を問い詰めます:

  • 既存ユーザーか、潜在的ユーザーか、解約ユーザーか?
  • その行動は現在行っているものか、新しい状況で行うものか?
  • 有意義なシグナルを得るには何人の参加者が必要か?(定性インタビュー: 通常6〜10人で飽和点に達する)

フェーズ3 — 調査を設計する

学習目標に基づいて適切な手法を選択します。JTBDインタビューを実施する場合は、インタビューガイドを生成します:

導入: 「[関連行動]を最後に行ったときのことを教えてください。その時何が起こっていたのか、順を追って説明してください。」

タイムライン: 「何がきっかけでしたか?最初に何を試しましたか?何があなたを継続させたり、諦めさせたり、切り替えさせたりしましたか?」

動機: 「これを実行した後、何が変わっていることを期待していましたか?何を心配していましたか?何があなたをほとんど止めさせましたか?」

締めくくり: 「これをよりよく理解するために、私が尋ねていないことで役立つことはありますか?」

デザイナーに注意を促す: 名詞(候補となるドメインオブジェクト)とユーザーが自然に使う言語に耳を傾けること — これはドメインレイヤーに情報を提供します。

フェーズ4 — 統合計画

リサーチに進む前に: 調査結果をどのように取得し整理するか合意します。ノート1つにつき1つの観察結果とし、それが対応するリサーチクエスチョンでタグ付けします。要約よりも生の引用を優先します。


Synthesiseモード

フェーズ1 — 現状把握

デザイナーに、持っている資料(トランスクリプト、ノート、データサマリーなど)を共有するよう依頼します。次のことを尋ねます: これはどのように収集されたか、どのような質問に答えるために設計されたか、その品質にどの程度自信があるか?

フェーズ2 — 観察結果を抽出する

具体的な観察結果 — ユーザーが言ったこと、行ったこと、感じたこと — を引き出します。生データに近いままに保ち、まだ解釈はしません。

ドキュメントではなく記憶に基づいて作業する場合は、次のように尋ねて引き出します:

  • 「ユーザーが行ったり言ったりしたことで、最も驚いたことは何ですか?」
  • 「異なるユーザー間で繰り返し出てきたことは何ですか?」
  • 「予想していなかった、ユーザーが苦労したことは何ですか?」

フェーズ3 — パターンを特定する

観察結果をテーマ別にグループ化します:

  • 行動をトリガーする繰り返し発生する状況
  • 共通の動機 — 繰り返し現れる根底にある目標
  • 共通の不安 — ユーザー間で見られるためらい
  • 回避策 — 製品がジョブを果たさないときにユーザーが行うこと

フェーズ4 — ジョブストーリー候補をドラフトする

パターンから: [状況]のとき、[動機]したいので、[期待する結果]できる。

それぞれについて: 「とき」は十分具体的か?「したい」は動機か解決策か?信頼度をマーク: 観測 / 推測 / 仮定。

フェーズ5 — リサーチギャップをフラグ付けする

観察結果がまだ答えていない質問は何か?このリサーチが伝えていないことで、デザイナーが知る必要があることは何か?これらはフォローアップのPlanモードセッションへの入力となります。


完了

以下の成果物を作成します:

  1. 主要な観察結果 — 重要な生の調査結果
  2. パターン — 裏付けとなる観察結果とともに関連テーマをグループ化したもの
  3. ジョブストーリー候補 — 信頼度付き
  4. リサーチギャップ — まだ答えられていない質問

最後に: "これらのジョブストーリーは、ユーザーニーズレイヤーで洗練する準備ができています。 /layers-user-needs を実行してそれらを処理してください。"

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

関連スキル