build-guide

/build-guide

1. 加载 ~/.claude/plugins/config/claude-for-legal/legal-clinic/CLAUDE.md → 角色（必须是 Supervising attorney）、执业领域和司法管辖区。
2. 使用以下工作流。
3. 如果用户不是 Supervising attorney，请停止并引导其使用相应命令（学生运行 /legal-clinic:ramp）。
4. 依次了解：执业领域 → 接案问题 → 教学方式 → 审核关卡 → 跨插件检查 → 当地规则。
5. 编写 ~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md。如有需要，创建 guides/ 目录。
6. 提议进行一次测试运行——按照已配置的方式运行 /legal-clinic:draft，让主管了解学生看到的内容。

/legal-clinic:build-guide

可以创建多个指南，每个执业领域一个。重新运行此命令即可修改。快速修改时，直接编辑指南文件。

---

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

目的

主管指南是一个调节器，可将面向学生的技能从“完成工作”调整为“教会学生完成工作”。此插件中的每项面向学生的技能都会在生成输出前读取指南：接案流程会询问主管希望提出的问题，起草技能会选择教学方式（协助 / 引导 / 教授），审核关卡会将主管关心的事项提交主管处理，跨插件检查则会为其他插件的技能添加监督层。

此技能可帮助主管在每个执业领域用 5–10 分钟编写指南。指南采用纯 Markdown 格式，存放在固定路径中，随时可以手动编辑。

适用对象：主管律师。 不适用于学生。学生运行 /legal-clinic:ramp，然后使用面向学生的技能；他们不负责编写指南。

工作成果标头

此技能生成的所有内容都是面向主管的配置文件，不是学生工作成果。请勿在此技能的输出前添加 [AI-ASSISTED DRAFT — requires student analysis and attorney review]——该标签用于学生输出。此技能编写的指南文件是主管配置文档；它与 CLAUDE.md 一起存放在插件配置目录中，而非案件工作区。

指南应涵盖的关键事项

将以下内容作为检查清单提供，供主管略过不答，或用作访谈目录：

• 学生接触案件前需要了解什么？（职业道德规则、保密要求、权限范围）
• 学生在此执业领域最常犯的 3–5 个错误是什么？技能应如何发现这些错误？
• 学生何时必须暂停并取得你的批准？（提交文件、发送给客户、作出陈述、提供策略建议）
• 面向客户的沟通应达到什么阅读水平？（法律援助通常以六年级阅读水平为目标）
• 每位学生都应了解哪些当地规则、表格或截止日期？
• 技能何时应教学，何时应代为完成？（按文件类型设置——你可以设定默认值，并按类型覆盖）

在访谈开始时逐项查看清单，让主管了解接下来的内容，并标记哪些事项已有明确想法、哪些事项还需要考虑。主管表示略过的事项一律跳过；在指南中注明“未指定——技能使用默认设置”。

工作流

第 1 步：确认角色

此技能面向主管。读取 ~/.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 完成入门，或请主管为你的诊所编写指南。

如果角色不是 Supervising attorney，请停止。

第 2 步：哪个业务领域？

这份指南适用于哪类诊所？（移民／住房／家庭／交易／刑事辩护／消费者／其他）

如果回答是“其他”，请对方提供一个简短名称——这个名称将用作文件名（小写，单词之间用连字符：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 中已存在指南，请询问：“[领域]的指南已存在于 [path]。你想 (a) 按章节修订，(b) 从头开始并覆盖，还是 (c) 先看看现有内容？”

第 3 步：受理问题

对于这种类型的诊所，学生应该询问新客户哪些问题？我会先采用[业务领域]的通用受理问题——告诉我需要添加、删除或修改哪些内容。学生应该留意哪些危险信号？什么情况适合本诊所受理，什么情况应转介出去？

展示该业务领域的通用受理问题默认项——使用 client-intake 使用的相同默认项（移民：身份、入境、既往申请、原籍国情况、家庭、犯罪记录、时间紧迫性；住房：住房类型、发生了什么、租约、宜居性、时间安排；家庭：关系、问题、子女、安全、命令、听证会；消费者：债务类型、联系情况、文件材料、申报事项、截止日期）。对于这四个领域以外的业务领域，请督导从头描述受理流程。

记录：要添加的问题、要删除的问题、要改写的问题、危险信号（列表）、适配标准（什么情况由诊所受理，什么情况应转介出去）。

第 4 步：教学方式

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

• 引导（默认）： 技能提供结构；学生补充实质内容；技能提供反馈。两者均衡——大多数诊所从这里开始。
• 辅助： 技能生成工作成果；学生通过审阅和编辑来学习。速度最快，教学性最低。适合接案量大的诊所，或截止日期紧迫的情况。
• 教学： 技能不生成工作成果——学生负责起草，技能提供苏格拉底式反馈，并且只有在学生尝试两次后才展示范例。速度最慢，教学性最高。适合研讨课形式的诊所，或以学习为首要目标的情况。

你可以按文档类型设置（例如，客户信函采用教学方式，案卷备忘录采用辅助方式）。

记录该业务领域的默认教学方式，以及任何按文档设置的覆盖项。技能读取的按文档设置如下：

• pedagogy_posture_default: assist | guide | teach
• pedagogy_posture_client_letter: [override]
• pedagogy_posture_memo: [override]
• pedagogy_posture_draft: [override]

如果督导提到技能目前尚未支持的文档类型，请在 pedagogy_posture_other: 区块中记录预期的教学方式并附上说明——未来的技能可以读取它。

第 5 步：审核关卡

哪些工作成果在发送给客户之前需要您审核？哪些可以由学生直接发送？默认设置：所有面向客户的内容都需要审核。

请将选项整理成一张由督导填写的表格：

工作成果	关卡
接案摘要	[学生撰写；督导在案件讨论会上审核 / 督导在客户查看前审核 / 学生留存]
备忘录（内部）	[督导审核 / 学生留存]
客户信函（预约 / 文件请求 / 简要状态）	[督导审核 / 学生直接发送]
客户信函（实质性建议 / 坏消息）	[始终由督导审核 — 不可更改]
文件草稿（法院 / 机构）	[始终由督导审核 — 不可更改]
发给法院的状态更新	[始终由督导审核 — 不可更改]
研究起步路线图	[学生可直接据此开展工作]

有些关卡不可协商：提供实质性建议的客户信函、法院文件以及发给法院的状态更新，都必须按照诊所的督导结构交由督导审核。请将这些标记为固定项；可配置的关卡仅限常规事项。

第 6 步：跨插件检查

您希望学生使用其他插件中的技能吗（定义术语检查、文档一致性、章节引用、研究核实）？我可以将这些技能纳入督导流程——学生执行检查，输出会标记不确定之处供您审核，未经您批准，任何内容都不会发出。

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

• **交易法诊所：**使用 commercial-legal:review（NDA 初步审查、供应商审查），并纳入督导流程：学生执行审查，输出会标记为需经督导审核后才能发给客户。
• **移民法诊所：**使用 litigation-legal:chronology，根据客户文件整理时间线；在将其用于文件申报前，标记为需经督导审核。
• **住房法诊所：**客户带来传票时使用 litigation-legal:subpoena-triage，并纳入督导流程：学生起草应对计划，由督导签字批准。
• **任何诊所：**如果学生处理的任何事项涉及向诊所外部共享个人数据，则使用 privacy-legal:triage。

如果督导提出想使用的跨插件技能，请记录：技能名称、学生应在何时使用、适用的督导流程要求（始终由审核人审核、仅在触发标记时审核、未经督导批准绝不使用）。

第 7 步：地方法规和司法管辖区

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

查看 CLAUDE.md → ## Jurisdiction — 州和主要法院已在冷启动时设置。本步骤用于记录执业领域特有的地方法规和表格（例如，“住房法院关于简易程序答辩的常设命令”、“当地 USCIS 办事处的申请邮寄地址”、“家庭法院自助服务中心表格及其获取方式”）。请提出整理一份简短提示清单，供面向学生的技能在起草或提供建议时使用。

第 8 步：编写指南

写入 ~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md。如果 guides/ 目录不存在，请创建该目录。使用以下结构：

# Practice-area guide: [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]

---

## 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]

---

## 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]

---

## 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] |

---

## 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]

根据督导的回答填写每个部分。只有督导明确表示留空时，才能留空；不要编造内容。

然后告知督导：

您的指南位于 ~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md。所有使用诊所插件处理 [执业领域] 事务的学生都会使用遵循该指南的技能。您可以直接编辑文件进行修改，也可以重新运行 /legal-clinic:build-guide 来修订某个部分。您可以拥有多份指南——每个执业领域一份。

步骤 9：提供一次试运行

想看看教学方式会如何改变体验吗？我会用 [posture] 模式运行 /legal-clinic:draft，并使用一封示例客户来信——你将看到学生会看到的内容。

如果主管同意，请模拟起草技能读取他们刚刚编写的指南，并按照配置的教学方式生成内容。完整演示一个周期，让主管确切了解学生会看到什么。

输出

该技能的“输出”是写入 ~/.claude/plugins/config/claude-for-legal/legal-clinic/guides/<practice-area>.md 的文件。与主管的对话是访谈；书面指南则是最终产物。

写入后，显示一段简短确认：

指南已写入。 [practice-area] 已完成配置：

• 受理： [N] 个自定义问题、[N] 个风险信号、[N] 项转介标准
• 教学方式：[posture default]，并为 [list if any] 设置了覆盖项
• 审核关卡：[summary of what routes to supervisor vs. student]
• 跨插件：[N] 项技能已接入

学生下次为此执业领域运行诊所命令时，就会看到这些更改。随时编辑 [path] 以进行修改，或重新运行 /legal-clinic:build-guide 进行修订。

此技能不会做什么

• 全局配置插件。 指南按执业领域分别配置。若要配置全插件设置（监督方式、司法辖区、执业领域），请使用 /legal-clinic:cold-start-interview。
• 撰写学生的工作成果。 这是面向主管的配置，而非供客户使用的草稿。
• 覆盖 cold-start 中设置的监督方式。 监督模式（正式队列 / 可配置标记 / 轻度介入）在设置时确定。指南中的审核关卡会针对该执业领域细化此模式，但不会取代它。
• 让学生技能跳过 AI 辅助标头、置信度标记或验证提示。 这些是共享防护基线。指南改变的是教学方式，而不是防护措施。