johnQ
237631147a
- 11 个超 20KB 的 SKILL.md 拆分，大章节移入 references/details.md - 7 处非标准字段（arguments/user_invocable）移入 metadata - 修 req-dev 4 条相对链接；validate 跳过行内代码避免  误报 - validate-skills.py: 23 warns -> 0 warns，0 errors
112 lines
3.1 KiB
Markdown
112 lines
3.1 KiB
Markdown
# 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`) |
|
||
| 思源笔记 | 商务合同笔记本 /物流合同/{甲方简称}-{乙方简称}-{年份} |
|