matter-workspace – 法律案件工作区管理 Skill

Skill 详细介绍

matter-workspace 是什么

matter-workspace 是 Anthropic 官方 claude-for-legal 仓库中的一个 Skill，面向法律工作场景中的「案件工作区」管理。它把与某个具体法律事项（matter）相关的文档、时间线、当事人、待办、研究笔记等内容，组织在一个结构化的工作区内，方便在 Claude Code 等支持 Skills 的 Agent 环境中反复调用、持续更新。

它是法律工作流的组织方法，本身不是独立软件。Skill 本质是一组指令与目录结构约定，不包含可执行程序，也不能脱离 Agent 单独运行。

它不是什么

– 不是法律数据库。不提供法条、判例、法规的最新版本内容。
– 不是法律意见生成器。不代替律师进行法律判断。
– 不是电子取证（eDiscovery）或文档审阅平台。不提供大规模文档检索、去重、编码能力。
– 不是案件管理系统（DMS）。不与律所现有案件管理软件做数据同步。

核心用途

法律工作通常围绕「一个事项（matter）」展开：一个诉讼、一次并购、一份合同谈判、一个合规调查。围绕同一个事项会产生大量文档、时间节点、沟通记录、待办事项。matter-workspace 的用途是给 Agent 一个固定的工作区结构，让 Agent 每次进入这个事项时都知道：

– 当前事项的背景与目标
– 已有哪些文档、放在哪里
– 关键时间线与截止日期
– 待办事项和负责人
– 相关研究笔记与先前判断

典型任务

– 初始化一个新事项的工作区，生成标准目录与模板文件
– 把新收到的文档归入正确位置并更新索引
– 从已有材料中整理出时间线
– 维护待办清单，标记截止日期与状态
– 汇总某一事项的当前进展，供律师快速回顾
– 在多个相关事项之间保持一致的文档组织方式

工作方式

Skill 通过约定工作区的目录结构、命名规则和关键文件（如事项概要、时间线、待办清单）来工作。Agent 读取这些约定后，按约定的方式读取、写入、更新工作区中的文件。所有内容以纯文本、Markdown 等形式保存在用户自己的环境里，不上传到第三方服务。

适合哪些用户

– 使用 Claude Code 或类似 Agent 工具处理法律事务的律师与法务
– 需要长期跟踪多个事项、文档分散、时间线复杂的团队
– 希望把重复性的整理、归档、待办维护交给 Agent 的个人

不适合哪些需求

– 需要权威法律依据检索与引用核验
– 需要大陆法律体系下的合规定性
– 需要团队级权限管理、审计日志
– 需要与既有案件管理软件做系统对接

Skill 安全评估

总体判断

matter-workspace 来自 Anthropic 官方 claude-for-legal 仓库，来源可信度较高，Skill 本身不包含独立可执行程序。它的主要行为是读取和写入用户指定的工作区文件。实际风险更多取决于用户把它指向哪个目录、允许 Agent 做哪些文件操作。

来源可信度

– 发布者为 Anthropic 官方组织，属于一手来源
– Skill 以指令和结构约定为主，代码执行面相对较小
– 具体版本行为以仓库当前内容为准，建议安装前查看仓库最新提交

文件读取与写入

– 必需：读取工作区内的文件（文档、笔记、清单）
– 必需：写入或更新工作区内的文件（索引、时间线、待办）
– 建议：把工作区限定在一个专用目录下，不要让 Agent 对整个磁盘或家目录拥有写权限
– 建议：敏感材料单独存放，必要时用只读方式挂载给 Agent

如果工作区包含当事人信息、未公开交易信息、受律师—客户保密特权覆盖的材料，需要格外注意 Skill 会把内容读入模型上下文。

网络访问

Skill 本身通常不需要网络访问。但是否发生网络请求取决于 Agent 的运行时配置，而不是 Skill。若希望对敏感事项做严格隔离，可以关闭 Agent 的联网能力，只保留本地文件操作。

Shell 与命令执行

Skill 不要求执行任意 Shell 命令。若工作区包含敏感材料，可以关闭 Agent 自动执行 Shell 的权限，把命令执行权留给用户手动确认。

凭证与保密

– Skill 本身不需要 API Key、Token 或 OAuth 凭证
– 但工作区内容会进入模型上下文，等同于把这些材料交给了模型服务方
– 不要把与工作区无关的密钥、密码、凭证放在同一目录
– 注意律师—客户保密特权与所在司法辖区的数据保护要求

提示注入风险

工作区中的文档可能来自外部（对方当事人、第三方）。若这些文档中包含针对 Agent 的指令，理论上存在提示注入风险。处理外部文档时，建议人工审阅后再交由 Agent 整理。

降低风险的操作

– 专用工作区目录，避免与系统其他内容混杂
– 关闭自动 Shell 执行
– 敏感事项关闭联网
– 外部文档先人工过一遍
– 定期检查 Agent 对工作区的改动

Skill 使用要求

一、Agent / 客户端

该 Skill 属于 Anthropic 官方 claude-for-legal 仓库，官方主要面向 Claude Code。在 Claude Code 中使用是最自然的路径。

官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式看，凡是支持 Skills、自定义指令加载或类似机制的环境，例如 Codex、Cursor、Trae、OpenClaw、WorkBuddy，通常也可以尝试使用。不同 Agent 的 Skill 加载方式、上下文注入方式和权限模型不同，兼容程度可能有差异，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先，其他兼容 Agent 可尝试 |
| 文件系统 | 需要一个可读写的本地工作区目录 |
| 网络 | Skill 本身不需要 |
| 其他运行时 | 官方未明确要求特定 Node.js / Python 版本 |

具体依赖以该 Skill 当前官方说明为准。

三、权限

– 文件读取：必需
– 文件写入：必需（更新索引、时间线、待办）
– Shell：可选，敏感事项建议关闭自动执行
– 网络：可选，敏感事项建议关闭
– 浏览器 / Docker / GitHub：不需要

四、账号 / API Key

Skill 本身不需要额外账号、API Key 或 Token。

需要区分两种情况：

– Skill 本身：无凭证要求
– 若 Agent 运行在云服务上，可能需要该服务本身的账号与凭证，这属于 Agent 层面，不是 Skill 层面

最小使用条件

1. 一个支持 Skills 的 Agent（Claude Code 优先）
2. 一个专用且可读写的工作区目录
3. 明确该事项的名称与基本背景
4. 对敏感材料决定是否关闭联网与自动 Shell

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应的 Agent 或终端执行。

如果不清楚自己的 Agent 如何安装，可以直接向当前 Agent 询问：

如何安装 anthropics/claude-for-legal#matter-workspace？

如何在 Claude Code 中安装 anthropics/claude-for-legal#matter-workspace？

如何在 Cursor 中安装 anthropics/claude-for-legal#matter-workspace？

让 Agent 根据自己的 Skill 加载与管理机制给出对应的安装步骤，比手工复制命令更稳妥。如果该 Skill 存在特殊的官方安装要求，以仓库当前说明为准。

二、安装后如何使用

安装后，Agent 会在与该 Skill 相关的任务中被触发。适合交给它的任务包括：新建一个事项工作区、整理收到的文档、维护时间线和待办、生成事项进展汇总。

使用时把事项背景说清楚，比反复堆砌指令更有效。下面是一些自然语言示例：

使用 matter-workspace，帮我为「XX 公司股权收购」这个事项建立工作区，先搭好目录结构和事项概要模板。

使用 matter-workspace，把这几份合同和邮件归入对应事项的工作区，并更新时间线。

使用 matter-workspace，汇总一下这个事项目前的进展、未完成待办和最近的关键节点。

建议先让 Agent 用「只读」方式浏览工作区，确认结构符合预期后，再允许它写入。

三、卸载

不同 Agent 的 Skill 安装位置与管理方式不同。通常可以选择：

– 通过对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill
– 直接删除 Skill 对应的目录或条目
– 直接询问当前 Agent：

如何卸载 anthropics/claude-for-legal#matter-workspace？

如果没有统一的卸载命令，直接询问当前 Agent 如何移除通常更稳妥。

卸载 Skill 不会自动删除已有的工作区文件。工作区数据独立于 Skill 存在，可以根据需要自行保留或清理。

常见问题

1. 这个 Skill 会不会把工作区内容上传到外部？

Skill 本身不发起网络请求。工作区内容是否会离开本机，取决于你使用的 Agent 及其配置。如果使用云端模型服务，上下文会传输到该服务；如需本地处理，需选择支持本地模型的 Agent。

2. 是否需要先懂法律或懂技术才能用？

不需要编程知识。Skill 的使用方式是自然语言描述任务。法律层面的判断仍由使用者负责，Skill 只处理组织、归档、汇总类的工作。

3. 工作区数据和 Skill 是一回事吗？

不是。Skill 是方法与结构约定，工作区是实际数据。删除 Skill 不影响工作区文件；反过来，工作区可以迁移到其他环境继续使用。

4. 可以同时管理多个事项吗？

可以。常见做法是为每个事项建立独立的工作区目录，Agent 根据任务描述进入对应工作区。保持命名和结构一致，跨事项的切换会更顺畅。

5. 安装后 Agent 没有识别到 Skill 怎么办？

先确认安装路径是否与 Agent 的 Skill 加载目录一致，再确认 Agent 是否需要重启或重新加载。若仍不生效，直接询问当前 Agent 该 Skill 应放在哪个位置、如何被识别。

6. 在中国大陆使用有网络要求吗？

Skill 本身不需要访问网络。是否可用主要取决于所用 Agent 的模型服务可达性。若使用云端模型服务，需按该服务的要求准备网络环境。

7. 适合直接用在生产环境的敏感案件上吗？

不建议在不做任何隔离的情况下直接用于高度敏感事项。更稳妥的做法是：专用目录、关闭自动 Shell、敏感事项关闭联网、外部文档人工审阅后再交由 Agent 处理。