---
name: ip-matter-workspace
description: >
  管理法律事项工作区——创建、列出、切换、关闭或脱离当前事项；当用户需要为多客户执业环境隔离上下文、创建新事项工作区、切换或归档事项时使用。
argument-hint: "<new | list | switch | close | none> [slug]"
---

# /matter-workspace-cn

律师同时在多个客户和事项间工作。事项工作区将某一客户或委托的上下文与其他客户完全隔离。本技能管理这些工作区。

## 子命令

- `matter-workspace-cn new <slug>` — 创建新事项工作区，执行简短建档，写入 `matter.md`
- `matter-workspace-cn list` — 列出事项及状态和活跃标记
- `matter-workspace-cn switch <slug>` — 设置活跃事项
- `matter-workspace-cn close <slug>` — 归档事项（移至 `<工作区根目录>/matters/_archived/`，永不删除）
- `matter-workspace-cn none` — 脱离当前活跃事项，仅在执业层级工作

## 操作指引

1. 读取执业层级配置文件（默认位于 `<工作区根目录>/CLAUDE.md`）——确认 `## 事项工作区` 章节已填写。如果 `已启用` 为 `否`，告知用户："事项工作区未启用——当前配置为公司内部执业模式，仅有一个客户，技能自动在执业层级上下文中运行。如果确实需要跨多个客户工作，请重新运行冷启动建档并选择外部执业模式。否则无需使用事项工作区。" 不要报错——禁用状态是内部用户的预期状态。
2. 按以下子命令逻辑执行。
3. 根据参数的第一个词分派：
   - `new` → 执行建档面谈，写入 `<工作区根目录>/matters/<slug>/matter.md`，创建 `history.md` 和 `notes.md` 初始文件。
   - `list` → 遍历 `<工作区根目录>/matters/*/matter.md`，打印表格，标记活跃事项。
   - `switch` → 更新执业层级配置文件中的 `活跃事项:` 行。
   - `close` → 将 `<工作区根目录>/matters/<slug>/` 移至 `<工作区根目录>/matters/_archived/<slug>/`，在 `history.md` 中记录关闭日期。
   - `none` → 将 `活跃事项:` 设为 `无 — 仅执业层级上下文`。
4. 向用户展示变更内容，写入前须确认。

## 备注

- 除非执业层级配置中 `跨事项上下文` 为 `开`，本技能绝不跨事项读取文件。
- 归档不是删除——关闭的事项仍可读取，用于留存和利益冲突审查。
- Slug 使用小写字母加连字符。如果活跃与归档中存在相同 slug，归档目录下的保留在 `_archived/<slug>/`。

---

多客户执业者（外部执业——个人、小型律所、大型律所）同时处理多个事项。一个事项的上下文绝不能泄露到另一个。本技能是使这一隔离生效的轻量文件管理层。

**默认状态为关闭。** 内部用户不会看到本功能——他们仅在执业层级工作。事项工作区在冷启动时为外部执业用户开启，或通过编辑执业层级配置中的 `## 事项工作区` 手动开启。如果 `已启用` 为 `否`，本技能不执行；而是说明禁用状态，并建议确实需要事项隔离的用户重新运行冷启动建档。

## 存储布局

所有事项数据存放于：

```
<工作区根目录>/
├── CLAUDE.md                       # 执业层级配置文件
└── matters/
    ├── <slug>/
    │   ├── matter.md               # 客户、对方当事人、事项类型、关键事实、覆盖设置
    │   ├── history.md              # 按日期记录的事件、决策、草稿、审阅日志
    │   ├── notes.md                # 自由格式工作笔记
    │   └── outputs/                # 本事项的技能输出（可选子目录）
    └── _archived/
        └── <slug>/                 # 已关闭事项——可读但非活跃
```

`<工作区根目录>` 为可配置的基础路径，由执业层级配置或运行时环境决定。默认值为 `<执业配置根目录>/ip-legal/`。禁止硬编码为特定智能体框架的个人目录路径。

Slug 使用小写字母加连字符。示例：`acme-trademark-2026`、`zenith-copyright`、`novacorp-fto`。

## 活跃事项记录于执业层级配置文件

执业层级配置文件中 `## 事项工作区` 下的 `活跃事项:` 行是唯一真实来源。切换事项即编辑该行。无单独状态文件。

## 子命令逻辑

### `new <slug>`

1. 确认 slug 在 `matters/<slug>/` 和 `matters/_archived/<slug>/` 中均不存在。如已存在，请用户选择不同 slug。
2. 执行建档面谈，收集以下信息：
   - **委托人**（我方代理的当事人，或内部业务单元）
   - **对方当事人**（相对方——可能为多方；可填"不明的第三方侵权人"，常见于监控触发事项）
   - **事项类型**（读取执业配置中的典型分类；常见类型见下表）

     | 事项类型 | 说明 |
     |---|---|
     | 商标查新/可注册性分析 | 商标注册前的检索与风险评估 |
     | 商标异议/无效 | 针对他人商标提起异议或宣告无效 [模型知识 — 需核验] |
     | 商标维权 | 商标侵权主张与维权行动 |
     | 著作权侵权/信息网络传播权维权 | 著作权及信息网络传播权侵权维权 [模型知识 — 需核验] |
     | 专利申请 | 专利申请相关事项 |
     | 专利无效 | 专利无效宣告请求 [模型知识 — 需核验] |
     | 专利侵权 | 专利侵权主张与抗辩 |
     | 专利自由实施分析(FTO) | 自由实施尽职调查 |
     | 知识产权条款审查 | 合同中知识产权条款的审查与谈判 |
     | 开源合规 | 开源许可证合规审查 |
     | 不正当竞争 | 反不正当竞争相关事项 [模型知识 — 需核验] |
     | 商业秘密 | 商业秘密保护与维权 [模型知识 — 需核验] |
     | 知识产权组合管理 | 知识产权资产组合的维护与管理 |
     | 其他 | 不属于以上分类的事项 |

   - **保密级别**（一般 | 加密级 | 隔离审查组——加密级在跨事项场景下需额外注意；隔离审查组常见于FTO项目）
   - **关键事实**（2–5句话：事项概要、相关方、争议核心、利益攸关之处）
   - **事项专属覆盖设置**（例如"本商标客户要求激进策略"、"对方为战略合作伙伴——仅用审慎措辞"、"发明人无法联系——不要提示面谈"）
   - **关联事项**（任何相关事项的 slug）
3. 使用下方模板写入 `matters/<slug>/matter.md`。
4. 用一条"创建"记录初始化 `matters/<slug>/history.md`。
5. 创建空的 `matters/<slug>/notes.md`。
6. **不要**自动切换到新事项。询问："是否切换到 `<slug>`？（使用 `matter-workspace-cn switch <slug>`）"

### `list`

遍历 `matters/*/matter.md`。读取每个文件的前言区或前几行以提取状态。打印表格：

| Slug | 委托人 | 事项类型 | 状态 | 创建日期 | 活跃 |
|---|---|---|---|---|---|

当前活跃事项标记 `*`。如有归档事项，在单独的"已归档"标题下列出 `_archived/*`。

### `switch <slug>`

1. 确认 `matters/<slug>/matter.md` 存在。如不存在，建议 `matter-workspace-cn new <slug>`。
2. 编辑执业层级配置文件中的 `活跃事项:` 行为 `活跃事项: <slug>`。
3. 向用户展示 matter.md 摘要，确认事项正确。

### `close <slug>`

1. 确认 `matters/<slug>/` 存在。
2. 在 `matters/<slug>/history.md` 末尾追加"关闭"记录，附当日日期。
3. 将 `matters/<slug>/` 移至 `matters/_archived/<slug>/`。
4. 如关闭的是活跃事项，将 `活跃事项:` 设为 `无 — 仅执业层级上下文`。

### `none`

将执业层级配置文件中的 `活跃事项:` 设为 `无 — 仅执业层级上下文`。向用户确认。

## `matter.md` 模板

```markdown
[工作成果抬头 — 按执业配置 ## 输出 — 因角色不同而异；参见执业层级配置中的 ## 使用角色说明]

# 事项: [委托人] — [简短描述]

**Slug:** [slug]
**创建日期:** [YYYY-MM-DD]
**状态:** 活跃
**保密级别:** [一般 / 加密级 / 隔离审查组]

---

## 当事人

**委托人:** [名称]
**对方当事人:** [名称]

## 事项类型

[商标查新/可注册性分析 | 商标异议/无效 | 商标维权 | 著作权侵权/信息网络传播权维权 | 专利申请 | 专利无效 | 专利侵权 | 专利自由实施分析(FTO) | 知识产权条款审查 | 开源合规 | 不正当竞争 | 商业秘密 | 知识产权组合管理 | 其他 — 附一句理由]

## 关键事实

[2–5句话。事项概要。相关方是谁。争议核心。与默认策略的不同之处。]

## 事项专属覆盖设置

*仅适用于本事项、不同于执业层级默认策略的偏差。*

- [例如"维权策略：本事项采用审慎策略，尽管律所默认为激进——对方为核心渠道合作伙伴。"]
- [例如"主张审批：任何函件发出前需额外获得市场部签字确认。"]
- [例如"隔离审查组：即使跨事项上下文全局开启，本事项文件仍不可跨事项读取。"]

## 关联事项

- [slug — 一句话说明关联原因]

## 保密说明

[如为加密级或隔离审查组，说明原因。谁可以查看本事项文件。即使跨事项上下文全局开启，本事项是否允许跨读取。]
```

## `history.md` 初始内容

```markdown
# 历史记录: [委托人] — [简短描述]

仅追加的事件日志。最新记录置顶。

---

## [YYYY-MM-DD] — 事项创建

建档完成。Slug: `[slug]`。状态: 活跃。
[任何值得在 matter.md 之外保留的初始上下文——例如"因监控服务发现 `APEXLEAF` 在第25类的命中而创建。"]
```

## 跨事项上下文

执业层级配置中有 `跨事项上下文:` 标志。当其值为 `关`（默认）时，在事项 A 中工作的技能**绝不读取** `matters/B/` 中任何其他 B 的文件。这是该设置存在的保密保障。

当其值为 `开` 时，仅当用户明确要求时（例如"跨事项列出我在该商标上发出的所有维权函"），技能方可跨事项文件夹读取文件。即使为 `开`，默认仍仅加载活跃事项，除非用户主动请求跨事项视图。

## 本技能不做的事

- **利益冲突检索。** 冲突审查是律师/律所的职责；建档仅记录用户声明。
- **留存策略执行。** 关闭仅归档事项，不删除。留存策略超出范围。
- **自动路由输出。** 实质技能决定写入内容；本技能告知其*哪个文件夹*处于活跃，而非应放入什么。
- **判断跨事项是否适当。** 本技能读取标志并遵守。

## 中国法适配说明

- 事项类型已按中国知识产权法律实务场景调整，涵盖商标法、专利法、著作权法、反不正当竞争法下的常见业务类型。具体法律依据和来源参见 [references/cn-legal-sources.md](references/cn-legal-sources.md)。
- 标有 `[模型知识 — 需核验]` 的事项类型定义，其法律效力或适用范围未经人工法律核验，实务使用前应确认。
- 路径引用使用 `<工作区根目录>` 代替特定智能体框架路径，具体路径由执业层级配置或运行时环境决定。

## 使用示例

- 示例1:
  - 场景/输入: 用户说"帮我创建一个新的事项，关于华远公司的商标维权"
  - 预期产出: 执行建档面谈，收集委托人、对方当事人、事项类型等信息，创建 `matters/huayuan-trademark-enforcement/` 目录及 matter.md、history.md、notes.md
  - 关键要点: 需确认 slug 不重复；建档面谈必须完整；不自动切换事项

- 示例2:
  - 场景/输入: 用户说"切换到 novacorp-fto 事项"
  - 预期产出: 确认该事项存在，更新执业层级配置中的活跃事项行，展示 matter.md 摘要
  - 关键要点: 如事项不存在，建议创建而非报错

- 示例3:
  - 场景/输入: 用户说"关闭 acme-trademark-2026 事项"
  - 预期产出: 追加关闭记录到 history.md，将目录移至 `_archived/`，如为活跃事项则重置
  - 关键要点: 归档不是删除；关闭活跃事项需重置活跃标记

## 资源索引

- 参考: 见 [references/cn-legal-sources.md](references/cn-legal-sources.md)（中国法法律来源与事项类型对照，读取时机：需要确认事项类型的法律依据或验证法律效力时）
- 参考: 见 [references/intake.json](references/intake.json)（本地化提交登记，读取时机：提交审核或集成时）
- 参考: 见 [references/notes.md](references/notes.md)（适配说明与待确认问题，读取时机：需要了解与原版的差异或待确认事项时）
- 参考: 见 [references/normal-case.md](references/normal-case.md)（正常使用样例，读取时机：需要典型场景参考时）
- 参考: 见 [references/edge-case.md](references/edge-case.md)（边界使用样例，读取时机：需要了解边界行为和人工门控场景时）
- 脚本: 见 [scripts/eval_matter_workspace.py](scripts/eval_matter_workspace.py)（5项eval测试脚本，验证创建/列表/切换/关闭/隔离审查组逻辑；运行:`python scripts/eval_matter_workspace.py`）

## 注意事项

- 仅在需要时读取参考文件，保持上下文简洁。
- 中国法法律结论均须标注来源；未核验内容标记 `[模型知识 — 需核验]`。
- 充分利用智能体能力，本技能为轻量文件管理层，不替代法律判断。