attune
について
`attune`スキルは、会話からユーザーのスタイル、専門知識、嗜好を分析することで、Claudeが動的にコミュニケーションを調整できるようにします。セッション開始時、コミュニケーションの齟齬が生じた後、またはコンテキストを切り替える際に使用することで、より良い連携を実現します。このスキルは重要な関係性の次元をマッピングし、基本的な意図の理解を超えて、真のユーザーとの調和を目指します。
クイックインストール
Claude Code
推奨npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/attuneこのコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
Attune
Calibrate to person → read style, expertise, register, implicit prefs from conv evidence. Attunement > alignment: alignment = "right problem?"; attunement = "meet them where they are?"
Use When
- New session start → calibrate before first substantive res
- Comm mismatched → too formal/casual/long/sparse
- Unexpected feedback → attunement gap
- Big ctx shift (debug → brainstorm)
- MEMORY.md holds user prefs
healUser-Intent check → surface OK but deeper off
In
- Required: Current conv ctx (implicit)
- Optional: MEMORY.md + CLAUDE.md via
Read - Optional: Mismatch symptom ("explanations too long")
Do
Step 1: Receive — Gather Signals
Observe before adapt. Reception first, analysis second.
- Read msgs for how they communicate:
- Length: short/direct or long/detailed?
- Vocab: jargon, plain, mixed?
- Tone: formal, casual, warm, efficient, playful?
- Structure: lists, prose, bullets, stream?
- Punctuation: precise, emoji, ellipses, exclam?
- Note what they skip → implicit assumptions
- MEMORY.md/CLAUDE.md → stored prefs = stable patterns
→ Comm fingerprint. Enough to match register.
If err: Signals ambiguous → match most recent msg tone. Attunement refines → not perfect immediately.
Step 2: Read — Assess Expertise and Context
Meet them at their level.
- Domain expertise:
- Expert: precise terms, skips basics, nuanced Qs
- Intermediate: knows concepts, asks specifics/edges
- Beginner: foundational Qs, general language
- Tool familiarity:
- High: refs tools/cmds/configs by name
- Medium: knows want, not incantation
- Low: outcome only, no tool refs
- Ctx depth:
- Deep: carries implicit ctx
- Moderate: knows project, not issue
- Fresh: no prior ctx
Attunement Matrix:
┌──────────────┬──────────────────────────────────────────────────┐
│ Signal │ Adaptation │
├──────────────┼──────────────────────────────────────────────────┤
│ Expert │ Skip explanations, use precise terms, focus on │
│ │ the novel or non-obvious. They know the basics. │
├──────────────┼──────────────────────────────────────────────────┤
│ Intermediate │ Brief context, then specifics. Confirm shared │
│ │ understanding before going deep. │
├──────────────┼──────────────────────────────────────────────────┤
│ Beginner │ Orient first, explain terms, provide context. │
│ │ Don't assume; don't condescend. │
├──────────────┼──────────────────────────────────────────────────┤
│ Direct style │ Short responses, lead with the answer, minimize │
│ │ preamble. Respect their time. │
├──────────────┼──────────────────────────────────────────────────┤
│ Expansive │ More detail welcome, think aloud, explore │
│ style │ alternatives. They enjoy the journey. │
├──────────────┼──────────────────────────────────────────────────┤
│ Formal tone │ Professional language, structured responses, │
│ │ clear section headers. Match their register. │
├──────────────┼──────────────────────────────────────────────────┤
│ Casual tone │ Conversational, contractions allowed, lighter │
│ │ touch. Don't be stiff. │
└──────────────┴──────────────────────────────────────────────────┘
→ Clear sense of expertise + style from evidence, not stereotype.
If err: Hard to gauge → err slightly more ctx. Over-explain correctable; under-explain = user lost.
Step 3: Resonate — Match the Frequency
Resonance, not mimicry. Meet, not become.
- Match length: 2 sentences in → not 2 paragraphs out
- Match vocab: their terms. "function" → don't say "method" unless distinction matters
- Match structure: bullets → bullets, prose → prose
- Match energy: excited → engaged; frustrated → calm competence; exploratory → explore with
- Don't over-match: Matching ≠ flattening. Wrong → correct in their register
→ Noticeable quality shift. User feels heard. Response written for them.
If err: Matching feels forced → over-calibrating. Goal = natural resonance. Approximate fine.
Step 4: Sustain — Carry Attunement Forward
Attunement = ongoing practice, not one-time.
- After each msg → register shifted?
- Note when working (smooth) vs drifting (repeats, corrections)
- Explicit pref ("be concise") → overrides inference
- Stable pref worth preserving → MEMORY.md
→ Sustained quality + micro-adjustments as conv evolves.
If err: Attunement degrades long session → breathe → re-read user's most recent msg before res. Mid-session re-attune lighter than full cycle.
Check
- Signals from actual evidence, not assumed
- Expertise assessed w/ specific evidence
- Res style matched register
- Adaptation natural, not forced
- Explicit prefs respected
- Comm quality improved
Traps
- Attunement as flattery: Match ≠ agree. Includes difficult truths in their register.
- Over-calibrating: Too much effort on how → content suffers. Lightweight.
- Expertise from identity: Don't infer from name/title/demographics. Read evidence.
- Frozen calibration: Initial read = start. People shift. Keep reading.
- Ignore explicit feedback: "too long" > any inference. Explicit beats implicit.
→
listen— deep attention for intent; attune = how, listen = whatheal— User-Intent Alignment check; attune goes deeper relationalobserve— sustained neutral; attune applies it to personshine— radiant authenticity; attune without it → mimicrybreathe— micro-reset → mid-session re-attune
GitHub リポジトリ
関連スキル
executing-plans
デザインexecuting-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。
requesting-code-review
デザインこのスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。
connect-mcp-server
デザインこのスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。
web-cli-teleport
デザインこのスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。
