bluerangala-feishu-lawtools

内容来源：SKILL.md（标准 Skill 格式） · 原始地址 · 查看安装指南

原始内容

---
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` 跳转到指定条文 |

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（推荐）

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

Claude Code

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

Codex

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

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

其他 Agent（OpenCode、Grok 等）

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

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

手动（通用）

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），但部分工具有用户配置才完整工作：

# /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 文档开头。

安装方式

# 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

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

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

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

② python3（仅 /law-news）

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`	导入法律条文，创建飞书文档
`/law-news`	fetch/transform	`tools/law-news/law-news.md`	获取法律资讯，整理为文章
`/law-highlight`	annotate/transform	`tools/law-highlight/law-highlight.md`	正文内标记（高亮/加粗/标色）
`/law-annotate`	annotate/ai	`tools/law-annotate/law-annotate.md`	AI 逐条生成批注解读
`docx-skill`	transform/annotate	`tools/docx-skill/docx-skill.md`	docx 文档审查/修订（跨 run 匹配、批注、留痕修订）

注意事项

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