Back to Details

client-comms-log

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/client-comms-log

/client-comms-log

  1. Use the workflow below.
  2. Require case-id (prompt if not provided).
  3. Route by flag: 
    • --add
      (default): capture direction, medium, student, summary, action items, follow-up due. Confirm with user. Append (prepend most-recent-first) to 
      ~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
      .
    • --read
      : show the most recent N entries.
    • --summary
      : one-paragraph condensed read.
    • --patterns
      : scan for unanswered comms, missed follow-ups, language gaps, tone shifts, contact gaps. Supervision-oriented.
  4. Integration: offer 
    /legal-clinic:deadlines --add
    if the log establishes a deadline; route to 
    /legal-clinic:semester-handoff
    via 
    --summary
    when relevant.
  1. 使用以下工作流。
  2. 需要case-id（若未提供则提示用户）。
  3. 按标志路由： 
    • --add
      （默认）：记录沟通方向、媒介、对接学生、摘要、行动项、跟进截止日期。需与用户确认。将内容追加（最新条目前置）至
      ~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
      。
    • --read
      ：显示最近N条记录。
    • --summary
      ：生成一段浓缩的摘要。
    • --patterns
      ：扫描未回复的沟通、遗漏的跟进、语言障碍、语气变化、沟通间隔等问题，面向监督场景。
  4. 集成功能：若日志中确定了截止日期，可调用
    /legal-clinic:deadlines --add
    ；相关时通过
    --summary
    路由至
    /legal-clinic:semester-handoff
    。

Client Communications Log

客户沟通日志

Purpose

目的

Four reasons to keep this log:
  1. Malpractice defense. If a client claims "no one ever told me [X]," a dated entry showing otherwise is the answer. Clinical professors carry professional liability on student work; contemporaneous records protect them.
  2. Continuity at handoff. The next semester's student takes over and reads the log; they don't re-ask the client questions already answered.
  3. Supervision visibility. Five unreturned voicemails over six weeks is a pattern. The log makes patterns visible that individual students might not flag on their own.
  4. File retention. Law school clinics have obligations to maintain complete client files. Communication history is part of that.
Light. Append-only. The student's job is to write a two-sentence entry after every contact; the skill formats it and appends.
保留该日志的四大原因：
  1. 职业过失抗辩：如果客户声称“从未有人告知我[X]”，带有日期的记录就是反驳的证据。临床教授对学生的工作负有职业责任，实时记录能为他们提供保护。
  2. 交接连续性：下学期接手的学生可以查看日志，无需重复询问客户已回答过的问题。
  3. 监督可见性：六周内五次未回复的语音留言是一种异常模式。日志能凸显单个学生可能未注意到的这类模式。
  4. 文件留存：法学院诊所负有留存完整客户文件的义务，沟通记录是其中的一部分。
轻量化设计，仅支持追加操作。学生的任务是在每次沟通后撰写两句话的记录，该工具会自动格式化并追加内容。

Load context

加载上下文

  • ~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
    (if exists) — append target
  • ~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md
    → not heavily read; this skill is case-scoped
  • ~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
    （若存在）——追加目标文件
  • ~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md
    → 无需重点读取；该工具为案件专属工具

Modes

模式

Flag: 
--add | --read | --summary | --patterns
(default: add)
标志：
--add | --read | --summary | --patterns
（默认：add）

--add
(default) — log a new entry

--add
（默认）——记录新条目

Inputs:
  • Case ID (required — which case)
  • Date + time (default: now)
  • Direction: 
    in
    (client → clinic) | 
    out
    (clinic → client)
  • Medium: 
    call | email | text | letter | in-person | video | voicemail-left | voicemail-received
  • Who (student): name
  • Who (client side): client name, or "third-party: [description]" if from opposing counsel, family member, etc.
  • Duration / length (e.g., "10 min call", "3-paragraph email", "45 min in-person meeting")
  • Summary: 2-4 sentences. What happened, what was substantive.
  • Action items:
    • What the student owes the client (with deadline)
    • What the client owes the student (with expected timing)
  • Follow-up due: date if applicable
  • Notes: anything that matters but doesn't fit above — language used, emotional tone, family dynamic observed
Before writing: show the user the formatted entry and ask for confirmation. Clinic records should be reviewed before they're written, not after.
Append to 
~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
. If the log doesn't exist, create it with a header:
markdown
undefined
输入项：
  • Case ID（必填——对应案件）
  • 日期+时间（默认：当前时间）
  • 沟通方向：
    in
    （客户→诊所）| 
    out
    （诊所→客户）
  • 沟通媒介：
    call | email | text | letter | in-person | video | voicemail-left | voicemail-received
  • 对接人（学生）：姓名
  • 对方联系人：客户姓名，若为对方律师、家属等第三方则填写“third-party: [说明]”
  • 时长/篇幅（例如：“10分钟通话”、“3段邮件”、“45分钟面谈”）
  • 摘要：2-4句话，说明沟通内容及核心事项
  • 行动项：
    • 学生需向客户完成的事项（含截止日期）
    • 客户需向学生完成的事项（含预期时间）
  • 跟进截止日期：适用时填写日期
  • 备注：其他重要但未涵盖的内容——使用语言、情绪状态、观察到的家庭关系等
**写入前：**向用户展示格式化后的条目并确认。诊所记录需先审核再写入，而非事后修改。
将内容追加至
~/.claude/plugins/config/claude-for-legal/legal-clinic/client-comms/[case-id]/log.md
。若日志不存在，需创建并添加头部：
markdown
undefined

Communications Log — [case name]

Communications Log — [case name]

Case ID: [case-id] Client: [name] Opened: [YYYY-MM-DD]
Append-only. Most recent at top.

Then prepend new entries at the top (most recent first).
Case ID: [case-id] Client: [name] Opened: [YYYY-MM-DD]
Append-only. Most recent at top.

随后将新条目前置（最新条目位于顶部）。

--read
— show recent entries

--read
——显示近期记录

Print the most recent N entries (default 5). Useful when picking up a case mid-semester or before a client call.
打印最近N条记录（默认5条）。适用于学期中途接手案件或客户通话前查阅。

--summary
— condensed read

--summary
——浓缩摘要

Produce a one-paragraph summary of the log — most recent contact, total entries, common medium, any open action items from the student side, any unanswered communications. Feeds 
/semester-handoff
and 
/status
.
生成一段日志摘要——包含最近一次沟通、总条目数、常用沟通媒介、学生侧未完成的行动项、未回复的沟通等内容。可为
/semester-handoff
和
/status
提供数据。

--patterns
— flag concerns across the log

--patterns
——排查日志中的异常情况

Scan for:
  • Unanswered communications from client. Client called or emailed N times without a response entry.
  • Missed follow-up. Action item with follow-up due date, and no later entry resolving it.
  • Language / accommodation issues. Client language noted as non-English; check whether outgoing communications have been in that language.
  • Escalation patterns. Client tone shifting (frustrated / distressed) across entries.
  • Gaps. Long stretches with no contact on an active case.
This is a supervision tool. Clinical professors running 
--patterns
across their cases see which students might need support.
扫描以下内容：
  • 未回复的客户沟通：客户多次来电或邮件但无回复记录。
  • 遗漏的跟进：带有跟进截止日期的行动项，但无后续解决记录。
  • 语言/适配问题：客户语言标注为非英语，需检查 outgoing communications是否使用该语言。
  • 情绪升级模式：客户语气在多条记录中出现变化（沮丧/焦虑）。
  • 沟通间隔过长：活跃案件长期无沟通记录。
这是一个监督工具。临床教授通过对所有案件运行
--patterns
，可以了解哪些学生需要支持。

Integration

集成功能

  • /client-letter
    :     after generating and sending a letter, offer to log it as an outgoing comm.
  • /status client
    :     when producing a client-facing status summary, offer to log it (often these summaries go to clients).
  • /client-intake
    :     first entry in every new case's log is the intake contact.
  • /semester-handoff
    :     handoff memos read 
    --summary
    for each case to populate the communications-history section.
  • /deadlines
    :     if a communication established a deadline ("client said they need to respond by Friday"), offer to 
    /deadlines --add
    .
  • /client-letter
    ：生成并发送信件后，可选择将其记录为 outgoing comm。
  • /status client
    ：生成面向客户的状态摘要时，可选择将其记录（此类摘要通常会发送给客户）。
  • /client-intake
    ：每个新案件日志的第一条记录为 intake contact。
  • /semester-handoff
    ：交接备忘录会读取每个案件的
    --summary
    内容，填充沟通历史部分。
  • /deadlines
    ：若沟通中确定了截止日期（如“客户表示需在周五前回复”），可调用
    /deadlines --add
    。

What this skill does not do

该工具不具备的功能

  • Store substantive legal analysis. That lives in intake, memo, and status files. The log is communication record — facts of contact, not legal strategy.
  • Auto-log from outside systems. If the clinic uses a case management system (Clio), an integration could pull call logs and emails automatically. That's a future add; not v1.
  • Edit past entries. Append-only. If an entry is wrong, write a new entry referencing and correcting it. The integrity of the log depends on not rewriting history.
  • Enforce log discipline. If a student doesn't log a call, the skill can't know. Log hygiene is a clinic-culture problem; the skill just makes logging easy.
  • Handle privileged or attorney-only notes. If the student needs to record strategic thinking, that goes in the case's internal analysis file, not the comms log.
  • 存储实质性法律分析：此类内容应存于 intake、备忘录和状态文件中。日志仅为沟通记录——记录沟通事实，而非法律策略。
  • 从外部系统自动记录：若诊所使用案件管理系统（如Clio），未来可集成自动提取通话日志和邮件的功能，但当前v1版本不支持。
  • 编辑过往条目：仅支持追加操作。若条目有误，需撰写新条目并引用更正内容。日志的完整性依赖于不篡改历史记录。
  • 强制记录规范：若学生未记录通话，工具无法知晓。记录规范属于诊所文化问题，工具仅能简化记录流程。
  • 处理保密或律师专属笔记：若学生需记录战略思考，应存入案件的内部分析文件，而非沟通日志。