Agent-almanac attune
install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/wenyan-lite/skills/attune" ~/.claude/skills/pjt222-agent-almanac-attune-8ac938 && rm -rf "$T"
manifest:
i18n/wenyan-lite/skills/attune/SKILL.mdsource content
調諧
調諧於人——從對話證據中讀取溝通風格、專業深度、情緒基調與隱含偏好。調諧深於對齊:對齊問「是否解對了問題」;調諧問「是否在其所在之處與之相會」。
適用時機
- 新會話之始——於首次實質回應之前先行校準
- 溝通顯失匹配——過於正式、過於隨意、過於詳盡、過於簡略
- 收到出乎意料的回饋之後——錯配即揭示調諧之缺
- 在差異甚大的上下文之間切換(如由技術除錯轉入創意發想)
- 當 MEMORY.md 記有值得重讀的用戶偏好
- 當
之用戶意圖對齊檢查顯示表面對齊而深層脫節heal
輸入
- 必要:當前對話上下文(隱式可用)
- 選擇性:MEMORY.md 與項目 CLAUDE.md 內所存之偏好(透過
)Read - 選擇性:具體的錯配徵狀(如「對此用戶,我的解釋過長」)
步驟
步驟一:承接——匯集信號
調諧始於承接,非始於分析。先觀察,後適應。
- 讀用戶訊息——非為內容(此乃對齊之責),而為其如何表達:
- 長度:簡短直接,還是鋪陳詳盡?
- 詞彙:技術術語、白話,抑或混合?
- 語調:正式、隨意、溫和、高效、俏皮?
- 結構:條列編號、散文段落、要點列舉、意識流?
- 標點:嚴謹標點、表情符號、省略號、驚嘆號?
- 留意用戶未說之處——所略、所假定你已知、所留之隱含
- 若 MEMORY.md 或 CLAUDE.md 可用,查其既存偏好——彼為足夠穩定而值得記錄之模式
預期: 對此人溝通方式之一幅圖像——非心理側寫,而是溝通指紋,足以配其基調。
失敗時: 信號曖昧(對話極短,或風格變動)時,以最新訊息之語調為基準。調諧隨時修煉,無須一蹴可幾。
步驟二:辨讀——評估專業與背景
判知此人所知,方能於其所在相會。
- 領域專業:用戶對所論主題知之幾何?
- 專家信號:術語精準、略過基礎、發問細緻
- 中階信號:熟知概念,但問具體或邊緣案例
- 新手信號:問基礎、用通俗語、尋方向感
- 工具熟稔度:用戶對相關工具駕馭如何?
- 高:指名具體工具、指令、配置
- 中:知所欲為,惟不諳精確咒語
- 低:述其所求結果,未及工具
- 上下文深度:用戶對當前情境之背景有多少?
- 深:已耕耘良久,攜帶隱含脈絡
- 中:知項目而不知具體議題
- 淺:無先備背景而至
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. │ └──────────────┴──────────────────────────────────────────────────┘
預期: 對用戶專業層級與偏好風格之清晰判斷,立足於對話證據,而非出自人口特徵或刻板印象。
失敗時: 專業難以測度時,寧可稍多背景而勿過少。過度解釋可事後修正;解釋不足則令人迷失而無從追問。
步驟三:共振——對其頻率
以溝通對應其人。非模仿,乃共振。不化為其人,而與其相會。
- 匹配長度:其寫兩句,你勿回兩段(除非內容實有所需)
- 匹配詞彙:用其所用之詞。其言「function」則勿改稱「method」,除非區別確有必要
- 匹配結構:其用要點,你亦結構回應;其作散文,你亦以散文回
- 匹配能量:其興奮則帶投入;其挫折則以沉穩應之;其探索則與之同行
- 勿過度匹配:匹配非自我抹平。用戶若有錯處,調諧非同意,而是以其基調傳達更正
預期: 溝通品質可察之變。用戶覺被聽見、被相會,非受說教或諂媚。回應如為其而寫,非泛泛之論。
失敗時: 匹配顯勉強或做作,或為過度校準。目標是自然共振,非精確模仿。允其大概即可。調諧是方向,非終點。
步驟四:持守——延續調諧
調諧非一次校準,乃持續之修煉。
- 用戶每則訊息後略作檢查:基調是否已移?人隨對話推進而調整其表達
- 留意調諧何時有效(交流順暢、誤解極少)、何時偏移(重複提問、反覆更正、流露挫折)
- 若用戶明言偏好(「請簡短些」、「可否再詳解」),視為強信號——其優先於你之推測
- 若偏好穩定、值得跨會話保留,可記於 MEMORY.md
預期: 整場會話溝通品質持穩,隨對話推演自然微調。
失敗時: 長時會話中調諧退化(回應愈趨泛化、失去校準)時,調用
breathe 暫停,重讀用戶最新訊息再回。會話中段之再調諧,較完整一輪為輕。
驗證
- 溝通信號取自真實對話證據,非為臆測
- 專業層級以具體證據評估(所用術語、所提問題)
- 回應風格配其基調(長度、詞彙、語調、結構)
- 調整自然,無勉強或模仿之感
- 用戶明言之偏好獲得尊重
- 調諧改善了溝通品質(誤解減少、流動更順)
常見陷阱
- 將調諧視為奉承:配其風格非全然附和所言。調諧亦含以其基調傳達難言之真
- 過度校準:耗神於如何說,而致內容受損。調諧宜輕,非主務
- 由身分推斷專業:勿以姓名、職稱、人口特徵推論專業。讀真實對話證據
- 凝固校準:初讀只是起點。人會變動。通場持續讀信號
- 忽視明確回饋:用戶若言「過長」,其優先於任何風格推論。明言勝於暗示
相關技能
— 深度承接注意以擷取意圖;調諧重於其如何表達,聆聽重於其所欲表達listen
— 用戶意圖對齊檢查;調諧更深入關係品質heal
— 持續中性觀察;調諧將觀察專用於人observe
— 光明本真;失卻本真之調諧淪為模仿shine
— 微重置,使會話中段再調諧成為可能breathe