# skills 详细内容

## 飞书文档集成

本技能已集成飞书文档，可将合同直接创建到飞书云文档。

### 权限说明

**重要**：飞书文档默认对组织内权限是开放的，允许编辑。创建的合同文档在组织内成员均可查看和编辑。如需限制访问权限，请在飞书中手动调整文档权限设置。

### 可用工具

| 工具 | 功能 |
|------|------|
| `create_document` | 创建空白飞书文档 |
| `write_document` | 向已有文档写入内容 |
| `create_and_write_document` | 创建文档并写入内容（推荐） |
| `get_document_info` | 获取文档信息 |

### 使用示例

```
# 创建合同文档
使用 feishu-doc MCP 的 create_and_write_document 工具：
- title: "软件订阅服务合同-智慧云彩与妗晨"
- content: [Markdown 格式的合同内容]
- folder_token: [可选，指定文件夹]
```

### 获取文件夹 Token

1. 在飞书中打开目标文件夹
2. 复制 URL 中的 folder token（格式如：`fldcnXXXXXX`）
3. 调用工具时传入 folder_token 参数

### 飞书输出格式规范

#### 开票信息表格

物流合同中的开票信息应使用**表格**格式展示，列宽配置：

| 配置项 | 值 | 说明 |
|--------|-----|------|
| 项目列宽 | 120px | 显示"名称"、"纳税人识别号"等标签 |
| 内容列宽 | 480px | 显示具体信息 |

```python
# 创建开票信息表格示例
from feishu_docx import FeishuDocx

docx = FeishuDocx()
doc = docx.create_document("物流服务合同")

# 创建表格（4行2列，指定列宽）
table = docx.create_table(doc["document_id"], rows=4, cols=2, col_widths=[120, 480])

# 填充内容
docx.fill_table(doc["document_id"], table, [
    ["名称", "重庆妗晨工贸有限公司"],
    ["纳税人识别号", "91500104MA7EJTPA6D"],
    ["地址、电话", "重庆市大渡口区跳磴镇海康路106号1-1 / 15213397998"],
    ["开户行及账号", "中国农业银行重庆大渡口天安支行 31230401040004386"],
])
```

#### 签章格式

推荐使用**独立区块式**签章格式：

```
【甲  方】

单位名称：重庆妗晨工贸有限公司

法定代表人（或授权代表）：                              （签字/盖章）

单位盖章：



签订日期：            年            月            日

─────────────────────────────────────────────────────

【乙  方】

单位名称：北京名风新能源科技有限公司

法定代表人（或授权代表）：                              （签字/盖章）

单位盖章：



签订日期：            年            月            日
```

**特点**：甲乙双方独立区块，留白充足，便于盖章签字。

#### 物流合同税率

| 服务类型 | 税率 | 发票类型 |
|----------|------|----------|
| 交通运输服务 | 9% | 增值税专用发票 |

#### 默认存储路径

| 平台 | 路径 |
|------|------|
| 飞书云文档 | ai-proj/01运营 (folder_token: `C80gfkRnzlonQ5d4AhOcOACDnNg`) |
| 思源笔记 | 商务合同笔记本 /物流合同/{甲方简称}-{乙方简称}-{年份} |