---
slug: "bluerangala-feishu-lawtools"
source_type: "skill_md"
source_url: "https://cdn.jsdelivr.net/gh/BluerAngala/feishu-lawtools@main/SKILL.md"
repo: "https://github.com/BluerAngala/feishu-lawtools"
source_file: "SKILL.md"
branch: "main"
---
---
name: feishu-lawtools
version: 1.2.0
description: "飞书法律工具箱。法律条文导入飞书在线文档、法律资讯获取、AI划重点标记、AI批注解读、Markdown/飞书文档→公众号排版、微信公众号草稿推送。触发方式：/law-import、/law-news、/law-highlight、/law-annotate、/法律导入、/法律资讯、/划重点、/法律批注、/公众号、/微信草稿"
compatibility: "pi, Claude Code, Codex, OpenCode - 任何能执行命令和调用 lark-cli 的 AI agent"
metadata:
  requires:
    bins: ["lark-cli", "python3", "node"]
  cross-agent: true
  categories:
    import: 导入与创建
    fetch: 外部数据获取
    annotate: 标记与批注
    transform: 格式转换
    ai: AI 内容生成
  tools:
    - tools/law-import/law-import.md
    - tools/law-news/law-news.md
    - tools/law-highlight/law-highlight.md
    - tools/law-annotate/law-annotate.md
    - tools/docx-skill/docx-skill.md
    - tools/wechat-draft/wechat-draft.md

---

# 飞书法律工具箱 (feishu-lawtools)

把法律法规从URL或本地文件导入飞书在线文档，获取法律资讯并整理为文章，结构化呈现（章节→条款），并支持AI自动逐条添加批注解读。

## 安装

### pi（推荐）

```bash
pi install git:github.com/BluerAngala/feishu-lawtools
# 或
pi install npm:@bluerangala/feishu-lawtools
```

### Claude Code

```bash
mkdir -p ~/.claude/skills
git clone https://github.com/BluerAngala/feishu-lawtools ~/.claude/skills/feishu-lawtools
```

### Codex

```bash
mkdir -p ~/.codex/skills
git clone https://github.com/BluerAngala/feishu-lawtools ~/.codex/skills/feishu-lawtools
```

> 也可在 Codex 中通过 `$skill-installer` 或 `AGENTS.md` 引用安装。

### 其他 Agent（OpenCode、Grok 等）

```bash
mkdir -p ~/.agents/skills
git clone https://github.com/BluerAngala/feishu-lawtools ~/.agents/skills/feishu-lawtools
```

> 或参考你的 agent 的文档，将本 skill 目录添加到对应的配置路径中。

### 手动（通用）

```bash
git clone https://github.com/BluerAngala/feishu-lawtools.git
cd feishu-lawtools
# 然后在你的 agent 配置中指向这个目录
```

---

## 系统依赖

各工具依赖汇总。AI agent 应在执行对应工具前置检查时确认依赖可用。

| 工具 | 全局依赖 | 用户配置 | 核心能力 | 说明 |
|------|----------|----------|----------|------|
| `law-import` | `lark-cli` | — | AI 指令 | URL/文件 → 飞书文档 |
| `law-news` | `lark-cli`, `python3` | `lawyer-profile.json`（可选） | Python 脚本 | 新闻抓取、排版、发布 |
| `law-highlight` | `lark-cli` | — | AI 指令 | 正文标记 |
| `law-annotate` | `lark-cli` | — | AI 指令 | AI 批注 |
| `→ 公众号` | `lark-cli`, `node` | — | 调用 `tools/md-to-wechat` CLI | Markdown/飞书文档 → 公众号 HTML |
| `docx-skill` | `node` | `docx-profile.json`（可选） | Node.js 脚本 | docx 文档审查/修订（跨 run 匹配、批注、留痕） |

> 公众号转换能力由 `tools/md-to-wechat/` 提供（18 主题的 Node.js 转换器，`scripts/cli.js`），非独立工具，各 skill 可直接调用。

> 「用户配置」列：某些工具有可选的个性化配置（如 `law-news` 的「律师说」评论档案），首次使用 AI 应提示用户 `cp` 示例配置并填写。

## 首次运行

每个工具按统一结构组织（`md + 脚本 + cache + .example.json + .json`），但部分工具有**用户配置**才完整工作：

```bash
# /law-news 第一次使用：复制并填写「律师说」评论档案
cp tools/law-news/lawyer-profile.example.json tools/law-news/lawyer-profile.json
# 然后编辑该 JSON，填入你的 label / signature / style_prompt
# ⚠️ style_prompt 必须包含划重点要求——核心关键词、法条、处罚后果用 **加粗** 标记（渲染后为红色加粗）
```

各工具的「首次使用」细节见对应 `tools/<name>/<name>.md` 文档开头。

### 安装方式

```bash
# lark-cli（所有工具必须）
npm install -g @larksuite/cli

# python3（仅 law-news 需要，macOS/Linux 自带，Windows 到 python.org 下载）
python3 --version

# node（仅公众号转换需要，macOS/Linux 自带或到 nodejs.org 下载）
node --version
```

> 所有 `.py` 脚本**仅使用 Python 标准库**，无需 `pip install`。
> 公众号转换依赖 `tools/md-to-wechat/scripts/cli.js`（Node.js 18 主题转换器）。

---

## ⚡ 前置检查

**每次执行任何命令前，先运行以下检查。**

### ① lark-cli

```bash
which lark-cli || npm install -g @larksuite/cli
lark-cli update --check --json
lark-cli auth status
```

如果 `tokenStatus` 不是 `"valid"`（或为 `"needs_refresh"`，会自动刷新），提示用户重新登录：

```bash
lark-cli auth login --scope "docx:document:create,docx:document:readonly,docx:document:write_only,drive:document.comment:create"
```

### ② python3（仅 /law-news）

```bash
python3 --version || echo "请到 https://python.org 安装 Python 3"
```

> 以上是自动前置检查，AI agent 应在响应用户需求前自行完成，不要问用户「装了吗」。

---

## 流程图

```
用户输入（URL / 文件路径 / 资讯源）
       ↓
 ① 提取内容或获取资讯列表
       ├─ 法律文本 → 提取正文
       └─ 资讯源 → API 获取新闻列表
       ↓
 ② 解析结构化：法律名称 → 章节 → 条文 / 新闻 → 文章
       ↓
 ③ 创建飞书在线文档（docs +create --api-version v2）
       ↓
 ④ AI 自动批注或划重点（可选）
       ├─ 逐条批注 → drive +add-comment（隐藏评论）
       └─ 划重点 → docs +update str_replace（正文加粗/标色）
       ↓
 ⑤ 用户手动批注（飞书原生功能，无需skill）
```

## 依赖技能

本 skill 在执行过程中可能需要调用以下技能处理子任务：

| 场景 | 调用 skill |
|------|-----------|
| URL 提取正文 | `baoyu-url-to-markdown` 或 `defuddle` |
| 本地文件读取 | `read` 工具直接读取 |
| 飞书文档创建/读取 | `lark-doc` |
| 飞书文档批注 | `lark-drive`（`+add-comment`） |
| 认证/权限 | `lark-shared` |

## 使用方式

### pi agent

在 pi 中直接使用以下命令：

```
/law-import    <url|file_path> [--title "自定义标题"]
/law-news      <source> [--days 3] [--max 10] [--style 简报|深度|专题]
/law-highlight <doc_url> <term> [--style highlight|bold]
/law-annotate  <doc_url> [--scope "article-1,article-5"] [--style 通俗|专业|案例]
```

### 其他 AI agent

非 pi agent 不支持 `/command` 格式。直接向 AI 描述需求即可：

> "把这个法律导入飞书文档" → `/law-import`
> "看看最近有什么法治新闻" → `/law-news`
> "给文档里的 '故意犯罪' 划重点" → `/law-highlight`
> "给这个法律逐条加 AI 批注" → `/law-annotate`
> "把这篇飞书文档转成公众号排版" → AI 调 `md-to-wechat` CLI + `lark-doc`

AI agent 会根据对应工具文件的步骤说明自动调用 `lark-cli` 完成操作。

## 工具索引

| 工具 | 分类 | 文件 | 功能 |
|------|------|------|------|
| `/law-import` | import/transform | [`tools/law-import/law-import.md`](https://github.com/BluerAngala/feishu-lawtools/blob/HEAD/tools/law-import/law-import.md) | 导入法律条文，创建飞书文档 |
| `/law-news` | fetch/transform | [`tools/law-news/law-news.md`](https://github.com/BluerAngala/feishu-lawtools/blob/HEAD/tools/law-news/law-news.md) | 获取法律资讯，整理为文章 |
| `/law-highlight` | annotate/transform | [`tools/law-highlight/law-highlight.md`](https://github.com/BluerAngala/feishu-lawtools/blob/HEAD/tools/law-highlight/law-highlight.md) | 正文内标记（高亮/加粗/标色） |
| `/law-annotate` | annotate/ai | [`tools/law-annotate/law-annotate.md`](https://github.com/BluerAngala/feishu-lawtools/blob/HEAD/tools/law-annotate/law-annotate.md) | AI 逐条生成批注解读 |
| `docx-skill` | transform/annotate | [`tools/docx-skill/docx-skill.md`](https://github.com/BluerAngala/feishu-lawtools/blob/HEAD/tools/docx-skill/docx-skill.md) | docx 文档审查/修订（跨 run 匹配、批注、留痕修订） |

## 注意事项

| 项目 | 说明 |
|------|------|
| ⏱️ 频率限制 | 添加批注时建议每条间隔 1-2 秒，避免 API 限流 |
| 📏 内容长度 | 单条批注内容建议不超过 500 字，过长可能被截断 |
| 🔑 身份 | 所有操作使用 `--as user`，确保有文档读写和评论权限 |
| 🧹 文档清理 | 创建空白文档后需先追加内容再获取 block_id |
| 🔗 文档链接 | 用户可以直接在文档 URL 末尾加 `#block_id` 跳转到指定条文 |