build-guide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/build-guide

Load
```
~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md
```
→ role (must be Supervising attorney), practice areas, jurisdiction.
Use the workflow below.
If the user is not the supervising attorney, stop and redirect (students run
```
/legal-clinic:ramp
```
).
Walk through: practice area → intake questions → pedagogy posture → review gates → cross-plugin checks → local rules.

Write

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

. Create the

guides/

directory if needed.

Offer a test run — run
```
/legal-clinic:draft
```
under the configured posture so the supervisor sees what a student sees.

/legal-clinic:build-guide

Multiple guides are fine — one per practice area. Re-run this command to revise. Edit the guide file directly for quick changes.

加载
```
~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md
```
→ 角色（必须为Supervising attorney）、执业领域、管辖区域。
遵循以下工作流程。
如果用户并非监管律师，请停止操作并引导（学生需运行
```
/legal-clinic:ramp
```
）。
逐步引导：执业领域 → 问诊问题 → 教学姿态 → 审核关卡 → 跨插件检查 → 本地规则。

写入文件

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

。若

guides/

目录不存在则创建。

提供测试运行选项——在配置的姿态下运行
```
/legal-clinic:draft
```
，让主管查看学生端的使用体验。

/legal-clinic:build-guide

支持创建多份指南——每个执业领域对应一份。重新运行此命令可修订指南。也可直接编辑指南文件进行快速修改。

Build Guide: Supervisor-Authored Practice-Area Guide

构建指南：主管撰写的执业领域指南

Purpose

目的

The supervisor guide is the dial that turns student-facing skills from "get the work done" into "teach the student to do the work." Every student-facing skill in this plugin reads the guide before producing output: intake asks the questions the supervisor wants asked, drafting skills pick a pedagogy posture (assist / guide / teach), review gates route to the supervisor on the items the supervisor cares about, and cross-plugin checks wrap other-plugin skills in a supervision layer.

This skill helps a supervisor author that guide in 5-10 minutes per practice area. The guide is plain markdown at a well-known path — edit it by hand anytime.

Audience: the supervising attorney. Not students. Students run

/legal-clinic:ramp

and then the student-facing skills; they don't author guides.

主管指南是将面向学生的技能从“完成工作”转向“教会学生完成工作”的调节工具。本插件中所有面向学生的技能在生成输出前都会读取该指南：问诊环节会提出主管指定的问题，起草技能会选择对应的教学姿态（assist / guide / teach），审核关卡会将主管关注的事项提交给主管审核，跨插件检查则会为其他插件的技能添加监管层。

本功能可帮助主管在5-10分钟内完成一个执业领域的指南撰写。指南采用纯Markdown格式，存储在固定路径下——可随时手动编辑。

受众：监管律师。不面向学生。学生需运行

/legal-clinic:ramp

完成入职，之后使用面向学生的技能；学生无需撰写指南。

Work-product header

工作产物头部说明

Every output from this skill is a supervisor-facing configuration artifact, not student work product. Do NOT prepend

[AI-ASSISTED DRAFT — requires student analysis and attorney review]

to the output of this skill — that label is for student outputs. The guide file this skill writes is a supervisor configuration document; it sits next to CLAUDE.md in the plugin config directory, not in a matter workspace.

本技能生成的所有输出均为面向主管的配置文件，而非学生工作产物。请勿在本技能的输出前添加

[AI-ASSISTED DRAFT — requires student analysis and attorney review]

标签——该标签仅用于学生输出。本技能生成的指南文件是主管配置文档，与CLAUDE.md一同存储在插件配置目录中，而非案件工作区。

Key things your guide should address

指南需涵盖的核心内容

Offer this as a checklist the supervisor can skip through or use as the table of contents for the interview:

What does a student need to know before they touch a case? (Ethics rules, confidentiality, their scope of authority)
What are the 3-5 most common mistakes students make in this practice area, and how should the skill catch them?
When must the student stop and get your sign-off? (Filing, sending to a client, making a representation, advising on strategy)
What's the reading level for client communications? (6th grade is the usual target for legal aid)
What local rules, forms, or deadlines should every student know?
When should the skill teach vs. do? (Per document type — you can set a default and override per type)

Walk through the checklist at the start of the interview so the supervisor knows what's coming and can flag which items they already have strong views on versus which they want to think through. Skip any item the supervisor waves off; note it in the guide as "not specified — skill uses defaults."

将以下内容作为清单提供给主管，供其快速浏览或作为访谈的目录：

学生接触案件前需了解哪些内容？（道德准则、保密规定、权限范围）
学生在该执业领域最常犯的3-5个错误是什么？技能应如何识别这些错误？
学生在哪些情况下必须停止工作并获得你的签字批准？（提交文件、发送给客户、作出陈述、提供策略建议）
客户沟通内容的阅读水平要求是什么？（法律援助通常以6年级水平为目标）
所有学生都应了解哪些本地规则、表格或截止日期？
技能应何时教学、何时直接完成工作？（可按文档类型设置——可设置默认值并针对特定类型进行覆盖）

在访谈开始时向主管展示该清单，让其了解后续流程，并标记哪些内容已有明确想法、哪些需要进一步思考。若主管跳过某一项，需在指南中注明“未指定——技能使用默认值”。

Workflow

工作流程

Step 1: Check role

步骤1：检查角色

This is a supervisor skill. Read

~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md

→

## Who's using this

→ Role. If the role is not "Supervising attorney," say:

This skill is for supervisors — it configures how the student-facing skills behave. If you're the supervisor, make sure your practice profile role is set to "Supervising attorney" in
/legal-clinic:cold-start-interview
. If you're a student, this isn't the right skill for you — run
/legal-clinic:ramp
to onboard, or ask your supervisor to author a guide for your clinic.

Stop if the role is not supervising attorney.

本技能面向主管使用。读取

~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md

→

## Who's using this

→ Role。若角色并非"Supervising attorney"，请告知：

本技能面向主管使用——用于配置面向学生的技能行为。若你是主管，请确保在
/legal-clinic:cold-start-interview
中将你的执业档案角色设置为"Supervising attorney"。若你是学生，本技能不适合你——请运行
/legal-clinic:ramp
完成入职，或请主管为你的诊所撰写指南。

若角色并非监管律师，请停止操作。

Step 2: Which practice area?

步骤2：选择执业领域

What clinic is this guide for? (Immigration / Housing / Family / Transactional / Criminal defense / Consumer / Other)

If the answer is "Other," ask for a short name — that name becomes the filename (lowercase, hyphenated:

immigration-removal-defense.md

transactional-nonprofit.md

, etc.).

Check the practice areas listed in

CLAUDE.md

→

## Clinic profile

→ Practice areas. If the chosen practice area is not listed there, note it: "I'll write this guide, but your practice profile doesn't list [area] as one of your clinic's practice areas. That's fine — you can add it later with

/legal-clinic:cold-start-interview --redo

— but the student-facing skills won't route intakes to this area until the profile lists it."

If a guide already exists at

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

, offer: "A guide for [area] already exists at [path]. Do you want to (a) revise it section-by-section, (b) start fresh and overwrite, or (c) see what's there first?"

本指南针对哪个诊所？（移民/住房/家庭/商事/刑事辩护/消费者/其他）

若回答为“其他”，请询问简短名称——该名称将作为文件名（小写、连字符分隔：

immigration-removal-defense.md

、

transactional-nonprofit.md

等）。

检查

CLAUDE.md

→

## Clinic profile

→ Practice areas 中列出的执业领域。若所选执业领域未在其中列出，请注明：“我将撰写本指南，但你的执业档案未将[领域]列为诊所的执业领域之一。这并无问题——你可稍后通过

/legal-clinic:cold-start-interview --redo

添加该领域，但在档案更新前，面向学生的技能不会将问诊请求路由至该领域。”

若

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

已存在指南，请提供选项：“[领域]的指南已存在于[路径]。你希望（a）逐节修订，（b）重新创建并覆盖，还是（c）先查看现有内容？”

Step 3: Intake questions

步骤3：问诊问题

What should students ask a new client for this clinic type? I'll start with a generic intake for [practice area] — tell me what to add, remove, or change. What red flags should students look for? What makes a case a good fit for your clinic vs. a referral out?

Show the generic intake defaults for the practice area — use the same defaults that

client-intake

uses (Immigration: status, entry, prior applications, country conditions, family, criminal history, timeline urgency; Housing: housing type, what happened, lease, habitability, timeline; Family: relationship, issue, children, safety, orders, hearings; Consumer: debt type, contacts, documentation, filings, deadlines). For practice areas outside those four, ask the supervisor to describe the intake from scratch.

Capture: questions to add, questions to remove, questions to rephrase, red flags (a list), good-fit criteria (what makes this a case the clinic takes vs. refers out).

针对该类型诊所，学生应向新客户询问哪些问题？我将先提供[执业领域]的通用问诊问题——请告知需要添加、删除或修改的内容。学生应留意哪些警示信号？哪些案件适合你的诊所，哪些需要转介？

展示该执业领域的通用问诊默认问题——与

client-intake

使用的默认问题一致（移民：身份、入境情况、过往申请、国家状况、家庭、犯罪记录、时间紧迫性；住房：住房类型、事件经过、租约、宜居性、时间线；家庭：关系、问题、子女、安全状况、命令、听证会；消费者：债务类型、联系方式、文件、提交记录、截止日期）。若不属于上述四个领域，请请主管从头描述问诊内容。

记录：需添加的问题、需删除的问题、需改写的问题、警示信号（列表）、适合标准（诊所承接的案件类型）。

Step 4: Pedagogy posture

步骤4：教学姿态

How much should the skills do vs. how much should the student do?

Guide (default): The skill produces structure; students fill in substance; the skill gives feedback. Balanced — most clinics start here.

Assist: The skill produces work product; students review and learn by editing. Fastest, least pedagogical. Good for high-volume clinics or when deadlines are tight.

Teach: The skill doesn't produce work product — students draft, the skill gives Socratic feedback and only shows models after two attempts. Slowest, most pedagogical. Good for seminar-style clinics or when learning is the primary goal.

You can set this per document type (e.g., teach for client letters, assist for file memos).

Capture the default posture for the practice area, and any per-document overrides. Per-document settings the skills read:

pedagogy_posture_default: assist | guide | teach

pedagogy_posture_client_letter: [override]

```
pedagogy_posture_memo: [override]
```
```
pedagogy_posture_draft: [override]
```

If the supervisor names a document type the skills don't currently have, record the intended posture in a

pedagogy_posture_other:

block with a note — future skills can read it.

技能应完成多少工作，学生应完成多少工作？

Guide（默认）：技能生成结构；学生填充内容；技能提供反馈。平衡型——大多数诊所初始选择此模式。

Assist：技能生成工作产物；学生通过编辑进行审阅和学习。速度最快，教学性最弱。适合高流量诊所或截止日期紧迫的情况。

Teach：技能不生成工作产物——学生起草，技能提供苏格拉底式反馈，仅在学生尝试两次后展示范例。速度最慢，教学性最强。适合研讨式诊所或以学习为主要目标的场景。

你可按文档类型设置（例如，客户信件采用Teach模式，文件备忘录采用Assist模式）。

记录该执业领域的默认姿态，以及针对特定文档的覆盖设置。技能读取的按文档设置包括：

pedagogy_posture_default: assist | guide | teach

pedagogy_posture_client_letter: [override]

```
pedagogy_posture_memo: [override]
```
```
pedagogy_posture_draft: [override]
```

若主管提及技能当前未涵盖的文档类型，请在

pedagogy_posture_other:

块中记录预期姿态并添加注释——未来的技能可读取该设置。

Step 5: Review gates

步骤5：审核关卡

Which work product needs your review before it goes to a client? Which can students send directly? Default: everything client-facing needs review.

Present the options as a table the supervisor fills in:

Work product	Gate
Intake summary	[student writes; supervisor reviews at case rounds / supervisor reviews before client sees / student keeps]
Memo (internal)	[supervisor reviews / student keeps]
Client letter (appointment / doc request / brief status)	[supervisor reviews / student sends directly]
Client letter (substantive advice / bad news)	[always supervisor — cannot override]
Draft filing (court / agency)	[always supervisor — cannot override]
Status update to court	[always supervisor — cannot override]
Research-start roadmap	[student works from it directly]

Some gates are non-negotiable: client letters that give substantive advice, court filings, and status to courts always route through the supervisor per the clinic's supervision structure. Flag those as fixed; the configurable gates are the routine ones.

哪些工作产物在发送给客户前需要你的审核？哪些可由学生直接发送？默认：所有面向客户的内容均需审核。

以表格形式呈现选项，供主管填写：

工作产物	审核关卡
问诊摘要	[学生撰写；主管在案件例会时审阅/主管在客户查看前审阅/学生留存]
备忘录（内部）	[主管审阅/学生留存]
客户信件（预约/文件请求/简要状态）	[主管审阅/学生直接发送]
客户信件（实质性建议/坏消息）	[必须由主管审核——不可覆盖]
提交文件草稿（法院/机构）	[必须由主管审核——不可覆盖]
向法院提交的状态更新	[必须由主管审核——不可覆盖]
研究启动路线图	[学生直接使用]

部分审核关卡不可协商：提供实质性建议的客户信件、法院文件以及向法院提交的状态更新始终需通过主管审核，符合诊所的监管结构。需将这些标记为固定设置；可配置的关卡为常规内容。

Step 6: Cross-plugin checks

步骤6：跨插件检查

Do you want students to use skills from other plugins (defined-terms checks, doc consistency, section references, research verification)? I can wrap them in supervision — the student runs the check, the output flags uncertainty for your review, nothing goes out without your sign-off.

Offer concrete examples tied to practice area:

Transactional clinic:
```
commercial-legal:review
```
(NDA triage, vendor review) wrapped so the student runs the review, the output is flagged for supervisor review before going to the client.
Immigration clinic:
```
litigation-legal:chronology
```
for building a timeline from client documents, flagged for supervisor review before it feeds a filing.
Housing clinic:
```
litigation-legal:subpoena-triage
```
when the client brings in a subpoena, wrapped so the student drafts the response plan but the supervisor signs off.
Any clinic:
```
privacy-legal:triage
```
if the student is handling any matter where personal data is shared outside the clinic.

If the supervisor names a cross-plugin skill they want, record: skill name, when students should use it, what supervision wrapper applies (always reviewer, only when flagged, never without supervisor).

你是否希望学生使用其他插件的技能（术语检查、文档一致性、章节引用、研究验证）？我可为这些技能添加监管层——学生运行检查，输出会标记需你审核的不确定内容，未经你的签字批准不得对外发送。

提供与执业领域相关的具体示例：

商事诊所：
```
commercial-legal:review
```
（NDA分类、供应商审核）添加监管层，学生运行审核后，输出会标记需主管审核的内容，之后才可发送给客户。
移民诊所：
```
litigation-legal:chronology
```
用于根据客户文件构建时间线，在用于提交文件前需标记为需主管审核。
住房诊所：当客户收到传票时使用
```
litigation-legal:subpoena-triage
```
，添加监管层后，学生可起草响应计划，但需主管签字批准。
任何诊所：若学生处理的案件涉及向诊所外共享个人数据，可使用
```
privacy-legal:triage
```
。

若主管指定了需要使用的跨插件技能，请记录：技能名称、学生使用场景、监管层类型（始终需审核、仅标记时需审核、未经主管批准不得使用）。

Step 7: Local rules and jurisdiction

步骤7：本地规则和管辖区域

What court(s) does your clinic practice in? Any local rules or forms students need to use?

Check

CLAUDE.md

→

## Jurisdiction

— the state and primary court are already set at cold-start. This step is for practice-area-specific local rules and forms (e.g., "Housing Court standing order on summary process answers," "USCIS filing address for the local field office," "Family Court self-help center forms and where to find them"). Offer to capture a short list of pointers the student-facing skills should use when drafting or advising.

你的诊所在哪些法院执业？学生需要使用哪些本地规则或表格？

检查

CLAUDE.md

→

## Jurisdiction

——初始设置时已确定州和主要法院。此步骤用于记录特定执业领域的本地规则和表格（例如，“住房法院关于简易程序答辩的常规命令”、“USCIS本地办事处的提交地址”、“家庭法院自助中心表格及获取途径”）。请提供选项，让主管记录学生起草或提供建议时需参考的简短列表。

Step 8: Write the guide

步骤8：撰写指南

Write to

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

. Create the

guides/

directory if it doesn't exist. Use this structure:

markdown

undefined

写入文件

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

。若

guides/

目录不存在则创建。使用以下结构：

markdown

undefined

Practice-area guide: [Practice area]

执业领域指南：[Practice area]

Authored by the supervising attorney via
/legal-clinic:build-guide
. Student-facing skills read this before producing output. Edit directly anytime.

Last updated: [date] Authored by: [supervising attorney name from CLAUDE.md]

由监管律师通过
/legal-clinic:build-guide
撰写。面向学生的技能在生成输出前会读取本指南。可随时直接编辑。

最后更新日期： [date] 撰写人： [CLAUDE.md中的监管律师姓名]

Intake

问诊

Questions to ask (supplement/replace the generic defaults):

[question 1]
[question 2]
...

Red flags (surface these in the intake summary if present):

[flag 1]
[flag 2]

Good-fit criteria (cases this clinic takes):

[criterion 1]
[criterion 2]

Refer-out criteria (cases this clinic does not take):

[criterion 1]
[criterion 2]

需询问的问题（补充/替换通用默认问题）：

[问题1]
[问题2]
...

警示信号（若存在需在问诊摘要中突出显示）：

[信号1]
[信号2]

适合标准（诊所承接的案件）：

[标准1]
[标准2]

转介标准（诊所不承接的案件）：

[标准1]
[标准2]

Pedagogy posture

教学姿态

pedagogy_posture_default: [assist | guide | teach]

Per-document overrides (optional):

pedagogy_posture_client_letter: [assist | guide | teach]

pedagogy_posture_memo: [assist | guide | teach]

pedagogy_posture_draft: [assist | guide | teach]

Rationale: [one or two sentences from the supervisor on why this posture — helps next semester's supervising attorney understand the choice]

pedagogy_posture_default: [assist | guide | teach]

按文档覆盖设置（可选）：

pedagogy_posture_client_letter: [assist | guide | teach]

pedagogy_posture_memo: [assist | guide | teach]

pedagogy_posture_draft: [assist | guide | teach]

理由： [主管提供的1-2句话说明选择该姿态的原因——帮助下学期的监管律师理解此选择]

Review gates

审核关卡

Work product	Gate
Intake summary	[gate]
Memo (internal)	[gate]
Client letter — routine	[gate]
Client letter — substantive	supervisor (fixed)
Draft filing	supervisor (fixed)
Court-facing status	supervisor (fixed)
Research roadmap	[gate]

工作产物	审核关卡
问诊摘要	[关卡设置]
备忘录（内部）	[关卡设置]
客户信件——常规	[关卡设置]
客户信件——实质性	主管审核（固定）
提交文件草稿	主管审核（固定）
面向法院的状态更新	主管审核（固定）
研究路线图	[关卡设置]

Cross-plugin checks

跨插件检查

Skill	When students use it	Supervision wrapper
[plugin:skill]	[situation]	[wrapper]

技能	学生使用场景	监管层类型
[plugin:skill]	[场景]	[监管层]

Local rules and jurisdiction

本地规则和管辖区域

Court(s): [from CLAUDE.md or additional courts for this practice area] Practice-area-specific local rules and forms:

[pointer 1]
[pointer 2]


Fill every section from the supervisor's answers. Leave a section empty only if the supervisor said so — do not invent content.

Then tell the supervisor:

> Your guide is at `~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md`. Every student who uses the clinic plugin for [practice area] will have skills that follow it. Edit the file directly to change anything, or re-run `/legal-clinic:build-guide` to revise a section. You can have multiple guides — one per practice area.

法院： [来自CLAUDE.md或该执业领域的其他法院] 特定执业领域的本地规则和表格：

[提示1]
[提示2]


根据主管的回答填充每个部分。仅当主管明确要求时才保留空白部分——不得自行编造内容。

之后告知主管：

> 你的指南已保存至 `~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md`。所有使用该诊所插件处理[执业领域]案件的学生，其技能都会遵循本指南的设置。可直接编辑文件进行修改，或重新运行 `/legal-clinic:build-guide` 修订特定章节。你可创建多份指南——每个执业领域对应一份。

Step 9: Offer a test run

步骤9：提供测试运行选项

Want to see how the pedagogy posture changes the experience? I'll run
/legal-clinic:draft
with a sample client letter under [posture] — you'll see what the student sees.

If the supervisor says yes, simulate the drafting skill reading the guide they just wrote and producing output under the configured posture. Walk through one full cycle so the supervisor sees exactly what a student would see.

你是否希望查看教学姿态如何改变使用体验？我将以[姿态]运行
/legal-clinic:draft
生成一份示例客户信件——你可查看学生端的体验。

若主管同意，请模拟起草技能读取刚撰写的指南并在配置的姿态下生成输出。完整演示一个周期，让主管准确了解学生的使用体验。

Output

输出

The skill's "output" is the file written at

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

. The conversation with the supervisor is the interview; the written guide is the artifact.

After writing, show a brief confirmation:

Guide written.
[practice-area]
is now configured:
Intake: [N] custom questions, [N] red flags, [N] refer-out criteria

Pedagogy: [posture default], with overrides for [list if any]

Review gates: [summary of what routes to supervisor vs. student]

Cross-plugin: [N] skills wired in
Students will see these changes the next time they run a clinic command for this practice area. Edit
[path]
anytime to change anything, or re-run
/legal-clinic:build-guide
to revise.

本技能的“输出”是写入

~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md

的文件。与主管的对话是访谈过程；撰写的指南是最终产物。

写入完成后，显示简短确认信息：

指南已撰写完成。
[practice-area]
已完成配置：
问诊：[N]个自定义问题，[N]个警示信号，[N]个转介标准

教学：默认[姿态]，针对[列出覆盖的文档类型（如有）]设置了覆盖值

审核关卡：[总结需提交主管审核和学生可直接处理的内容]

跨插件：已接入[N]个技能
学生下次运行该执业领域的诊所命令时，将看到这些更改。可随时编辑
[path]
修改内容，或重新运行
/legal-clinic:build-guide
进行修订。

What this skill does NOT do

本技能不具备的功能

Configure the plugin globally. The guide is per-practice-area. For plugin-wide config (supervision style, jurisdiction, practice areas), that's
```
/legal-clinic:cold-start-interview
```
.
Author student work product. This is supervisor-facing configuration, not a draft for a client.
Override the supervision style from cold-start. The supervision model (formal queue / configurable flags / lighter-touch) is set at setup. Review gates in the guide refine that model for this practice area; they don't replace it.
Make a student skill skip the AI-assisted header, the confidence flags, or the verification prompts. Those are shared-guardrail baselines. The guide changes posture, not guardrails.

全局配置插件：指南是针对特定执业领域的配置。插件全局配置（监管风格、管辖区域、执业领域）需使用
```
/legal-clinic:cold-start-interview
```
。
生成学生工作产物：本技能生成的是面向主管的配置文件，而非客户草稿。
覆盖初始设置的监管风格：监管模式（正式队列/可配置标记/轻量监管）在初始设置时确定。指南中的审核关卡是针对该执业领域对该模式进行细化，而非替换。
让学生技能跳过AI辅助头部、置信度标记或验证提示：这些是共享的安全基线。指南仅改变教学姿态，不修改安全基线。