Skip to main content
Legalai.guide
claude tutorialClaude tutorial

Tutorial 09: Custom Legal Skills, Hooks & Agents

Build custom skills for your firm's workflows, create compliance hooks, and deploy multi-agent systems for complex legal tasks.

What You'll Learn

本教程介绍如何构建自定义法务技能、添加安全检查（钩子）并运行多智能体工作流程。需具备一定技术熟悉度。

专家级别

建议具备开发者技能。预计时长：120 分钟。

Claude Code 2.1.181 来源核查

Claude Code 2.1.181 增加了 /config key=value、面向 sandboxed macOS Apple Events 的 opt-in 设置 sandbox.allowAppleEvents、CLAUDE_CLIENT_PRESENCE_FILE、在思考过程中 API 连接掉线时更好的 retry 行为、在 network drives 和 cloud-synced folders 上更安全的 Write/Edit、MCP tools/list failure visibility，以及多项 background sessions、subagents、Remote Control、clipboard、settings 和 timezone 修复。Allowlisted 的 Claude Code Action 也把其 bundled 默认版本提升到 Claude Code 2.1.181 和 Claude Agent SDK 0.3.181。对于法律仓库，在让无人值守 workflows 触碰含客户数据的文件夹前，请重新测试 managed settings changes、macOS automation permissions、cloud-folder file-write behavior、MCP health checks、background-session history retention、subagent depth controls 和 GitHub Action version pins。

Claude Code 2.1.183 来源核查

Claude Code 2.1.183 通过阻止未被请求的 destructive git 和 infrastructure-destroy commands 来强化 auto-mode 安全性，在请求的模型已 deprecated 或被自动更新时发出警告，新增用于 commit 和 PR attribution 的 attribution.sessionUrl 设置，修复 scheduled task 与 webhook trigger 的分类使其不能批准 pending actions，并修复 headless 与 SDK 模式下 MCP auth-stub tools 的暴露。Allowlisted 的 Claude Code Action 也把其 bundled 默认版本提升到 Claude Code 2.1.183 和 Agent SDK 0.3.183。对于法律仓库，在让无人值守 workflows 触碰含客户数据的文件夹前，请重新测试 destructive-command review gates、webhook 与 scheduled-task approval boundaries、model-retirement warnings、PR attribution policy、MCP authentication exposure 和 version pins。

Claude Action 过滤 PR review

2026 年 6 月的一项 allowlisted Claude Code Action commit 现在会把 pull-request reviews 和 inline review comments 过滤到 authorized trigger time，与现有 issue/PR comments 和 bodies 的 trigger-time filtering 保持一致。对于 legal PR agents，请 pin 包含该 fix 的 version，把 trigger 之后新增的 review threads 视为不可信的参考上下文，保持 checkout credentials non-persistent，并在 agent-authored changes 到达含客户数据的 repositories 之前要求 human merge review。

学习目标

完成本教程后，您将能够：

  • 理解 Claude Code 的架构（Skills、Hooks、Sub-agents）
  • 为事务所工作流程构建自定义法务技能
  • 创建质量控制与合规钩子
  • 为复杂法务任务部署多智能体系统

第 1 部分：理解 Claude Code 栈

架构概览

Skills： 根据上下文 Claude 读取的文件中存储的专业指示和最佳实践。

Hooks： 在 Claude 执行生命周期的特定时点运行的脚本。

Sub-agents： 为处理特定子任务而启动的自主代理。

MCP 服务器： 外部工具连接（参见教程 07）。

Plugins： Skills + Hooks + MCP 的打包组合。

法律应用

组件法律应用
Skills编码 playbook、审查程序、起草标准
Hooks执行合规、防止未授权操作、审计日志
Sub-agents并行文档审查、研究任务
Plugins打包事务所工作流以供分发

第 2 部分：构建自定义法务技能

什么是 Skills？

Skills 是存储在 Claude 根据上下文读取的文件中的专业指示。与一次性提示不同，Skills 持久存在并自动激活。

Skill 文件结构

your-skill/
├── SKILL.md          # 主要指示（必需）
├── examples/         # 输入/输出示例
├── templates/        # 文档模板
└── resources/        # 参考资料

创建合同审查 Skill

步骤 1： 创建 skill 目录（命令见英文版）。

步骤 2： 编写 SKILL.md，包含 Purpose、Activation、Instructions、Output format。

步骤 3： 在 examples/ 中添加 good/bad 示例。

第 3 部分：构建合规 Hooks

什么是 Hooks？

Hooks 是在 Claude 操作的特定时点执行的脚本：PreToolUse、PostToolUse、SessionStart、UserPromptSubmit、Stop。详见英文版表格和示例。

生产提示： Hooks 可能阻止或改变工作流。在用于客户事项或特权文件前，请用真实权限、effort 级别和 MCP 服务器在沙盒中测试。

法务合规 Hook 示例

防止对特权文件夹进行未授权修改。详见英文版代码。

其他 Hook 用例

引用验证、保密性检查。详见英文版示例。

第 4 部分：多智能体法务工作流程

理解 Sub-agents

Claude 可启动 sub-agents 处理特定任务：并行化、专业化、隔离。详见英文版示例。

示例：并行尽职调查审查

多个 agents 并行（客户合同、IP、雇佣、诉讼）。详见英文版代码。

示例：研究 + 起草工作流程

研究 agent → 起草 agent → 审查 agent。详见英文版流程。

第 5 部分：将 Skills 打包为插件

插件结构

plugin.json、SKILL.md、.mcp.json、hooks/、commands/、resources/。详见英文版。

插件清单

格式与模式持续演进。请参阅官方插件参考。

安装与分发

claude --plugin-dir、claude plugin install、claude plugin enable。详见英文版。

第 6 部分：安全考虑

Skill 安全

来源验证、代码审查、不在 skill 中包含客户数据、访问控制。

数据保护

UserPromptSubmit 钩子用于清理。详见英文版。

合规要求

  • IT 安全审查 Skills
  • 沙盒中测试 Hooks
  • 启用审计日志
  • 验证客户数据隔离

立即执行

  • 为事务所的审查流程创建自定义 skill
  • 添加至少一个合规或审计用安全检查（hook）
  • 测试并行文档处理的多智能体工作流程
  • 为团队记录 skill
  • 考虑打包为插件以供分发

相关系列页面

导航

Quick Reference: Claude Code Commands

Official Claude Code terminal screenshot showing Claude running in a command-line workflow

Official Claude screenshot from Claude Code. Terminal workflows should be paired with scoped folders, explicit permission modes, and a reviewable diff before legal workflow changes are accepted.

# Skills (filesystem locations)
~/.claude/skills/           # Personal custom skills
.claude/skills/             # Project custom skills
 
# Hooks
/hooks                      # Open hooks manager in Claude Code
 
# Plugin hooks
${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json
 
# Debugging
claude --help

Sources

Additional Reading

On this page