---
name: feishu-cli-create
description: 快速创建飞书云文档。当用户请求"创建文档"、"新建文档"、"写一份文档"时使用。创建后必须立即添加 full_access 权限给默认接收人。
argument-hint: <title>
user-invocable: true
allowed-tools: Bash
---

# 飞书文档创建技能

快速创建一个新的飞书云文档。

## 使用方法

```bash
/feishu-create "文档标题"
```

## 执行流程

1. **创建空文档**
   ```bash
   feishu-cli doc create --title "<title>" --output json
   ```

2. **添加权限（必须）**
   创建后**必须立即**给 `user@example.com` 授予 `full_access` 权限：
   ```bash
   feishu-cli perm add <document_id> --doc-type docx --member-type email --member-id user@example.com --perm full_access --notification
   ```

   **full_access 权限包含**：
   - 管理协作者（添加/移除成员、设置权限）
   - 编辑文档内容（修改、删除、添加）
   - 管理文档设置（复制、移动、删除文档）
   - 查看历史版本
   - 导出文档

3. **发送通知（必须）**
   使用飞书消息通知用户文档已创建：
   ```bash
   feishu-cli msg send --receive-id-type email --receive-id user@example.com --text "文档已创建：https://feishu.cn/docx/<document_id>"
   ```

4. **返回结果**
   - 文档 ID
   - 文档 URL

## 输出格式

```
已创建文档！
  文档 ID: <document_id>
  文档链接: https://feishu.cn/docx/<document_id>
  权限: 已添加 full_access 给 user@example.com
```

## 可选参数

| 参数 | 说明 |
|------|------|
| --folder | 指定父文件夹 Token |

## 权限要求

- `docx:document` - 文档读写
- `drive:permission:member:create` - 添加协作者

## 注意事项

**必须遵守的规则**：
1. 创建文档后**必须立即**添加 `full_access` 权限给 `user@example.com`
2. 必须发送飞书消息通知用户操作完成
3. 返回结果中必须包含权限添加状态

## 示例

```bash
# 创建简单文档
/feishu-create "项目计划"

# 创建带时间戳的文档
/feishu-create "会议纪要-$(date +%Y%m%d)"
```