feishu-doc-optimizer
飛書(Feishu)のクラウド文書の構造や階層を最適化し、不要な書式を整理して見栄えを良くすることで、内容をより分かりやすく美しく改善するSkill。
📜 元の英語説明(参考)
飞书云文档内容优化与格式美化。当用户需要优化飞书文档的排版、结构、格式、美观度时使用此技能。支持:(1) 读取飞书文档内容 (2) 优化文档结构和层次 (3) 清空并替换文档内容 (4) 通过浏览器自动化编辑文档。触发词:优化飞书文档、美化文档、整理文档格式、文档排版。
🇯🇵 日本人クリエイター向け解説
飛書(Feishu)のクラウド文書の構造や階層を最適化し、不要な書式を整理して見栄えを良くすることで、内容をより分かりやすく美しく改善するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o feishu-doc-optimizer.zip https://jpskill.com/download/8154.zip && unzip -o feishu-doc-optimizer.zip && rm feishu-doc-optimizer.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8154.zip -OutFile "$d\feishu-doc-optimizer.zip"; Expand-Archive "$d\feishu-doc-optimizer.zip" -DestinationPath $d -Force; ri "$d\feishu-doc-optimizer.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
feishu-doc-optimizer.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
feishu-doc-optimizerフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
飞书云文档优化器
飞书云文档の内容構造、レイアウト形式、および視覚的な美観を最適化します。
ワークフロー
1. ドキュメント内容の読み取り
飛書 API を使用してドキュメントの元の内容を読み取ります。
python3 scripts/feishu_doc_reader.py <doc_token>
ドキュメントの token は URL から抽出します:https://xxx.feishu.cn/docx/<doc_token>
2. 内容の分析と最適化
最適化の原則:
- 構造の明確化:標準の章番号を使用(1. 2. 3.)
- 階層の明確化:1 級見出し、2 級見出し、本文の階層を明確化
- 内容の洗練:冗長な部分を削除し、核心的な情報を保持
- 視覚的な美観:emoji マーク、区切り線、表の配置を使用
3. ドキュメント内容の置換
Playwright ブラウザ自動化を使用します。
python3 scripts/feishu_doc_editor.py <doc_token> <content_file>
フロー:
- ログイン済みのブラウザに接続
- ドキュメントを開いて編集モードに入る
- Ctrl+A + Backspace を繰り返し、内容を空にする
- 新しい内容を 1 行ずつ入力する
飞书 API 設定
テナント設定
| テナント | App ID | 用途 |
|---|---|---|
| hanxing | YOUR_FEISHU_APP_ID | 汉兴企业(デフォルト) |
| personal | cli_a83467f9ecba5013 | 個人アプリケーション |
API 権限
必要な権限範囲:
docx:document:readonly- ドキュメントの読み取りdocx:document- ドキュメントの編集(API 方式)
最適化テンプレート
プロジェクトドキュメントテンプレート
# [プロジェクト名称]
> [一言で説明]
> 📅 バージョン:vX.X | 更新日:YYYY-MM-DD
---
## 📋 目次
1. プロジェクトの背景 2. システムアーキテクチャ 3. コア機能 ...
---
## 1. プロジェクトの背景
### 1.1 課題分析
🔴 課題 1 - 説明 ⭐⭐⭐⭐⭐
🔴 課題 2 - 説明 ⭐⭐⭐⭐
### 1.2 解決策
解決策の説明...
---
## 2. コア機能
### 2.1 機能名 ✅
**機能**:機能の説明
**フロー**:ステップ 1 ➜ ステップ 2 ➜ ステップ 3
---
## N. プロジェクトの価値
### N.1 投入コスト
| 項目 | コスト | 説明 |
|------|------|------|
| 項目 1 | ¥0 | 説明 |
### N.2 産出価値
⏱️ 指標 1:説明
💰 指標 2:説明
---
💡 改善提案がありましたら、ぜひお寄せください!
形式規範
Emoji の使用
| シーン | Emoji |
|---|---|
| 目次/ナビゲーション | 📋 |
| 日付/バージョン | 📅 |
| 課題/問題 | 🔴 |
| 完了 | ✅ |
| 進行中 | 🔄 |
| ToDo | ⏳ |
| 重要なヒント | ⚠️ 💡 |
| データ収集 | 📥 |
| データ処理 | ⚙️ |
| データ表示 | 📊 |
| 時間 | ⏱️ |
| コスト | 💰 |
| 成長 | 📈 |
区切り文字
- 章の区切り:
---(3 つの短点線) - フロー矢印:
➜ - 星評価:
⭐⭐⭐⭐⭐
表形式
| 列 1 | 列 2 | 列 3 |
|:---:|------|:---:|
| 中央揃え | 左揃え | 中央揃え |
注意事項
- ログイン状態:ブラウザでの編集には飛書へのログインが必要です
- API 制限:飛書 API はドキュメントブロックの直接削除をサポートしていません
- 編集モード:ドキュメントが「閲覧」モードではなく「編集」モードになっていることを確認してください
- 保存確認:編集後、「クラウドに保存されました」というメッセージが表示されるまでお待ちください
関連ファイル
scripts/feishu_doc_reader.py- ドキュメント内容の読み取りscripts/feishu_doc_editor.py- ドキュメント内容の編集references/optimization-examples.md- 最適化事例の参考
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
飞书云文档优化器
优化飞书云文档的内容结构、排版格式和视觉美观度。
工作流程
1. 读取文档内容
使用飞书 API 读取文档原始内容:
python3 scripts/feishu_doc_reader.py <doc_token>
文档 token 从 URL 提取:https://xxx.feishu.cn/docx/<doc_token>
2. 分析并优化内容
优化原则:
- 结构清晰:使用标准章节编号(1. 2. 3.)
- 层次分明:一级标题、二级标题、正文层次清晰
- 内容精炼:删除冗余,保留核心信息
- 视觉美观:使用 emoji 标记、分隔线、表格对齐
3. 替换文档内容
通过 Playwright 浏览器自动化:
python3 scripts/feishu_doc_editor.py <doc_token> <content_file>
流程:
- 连接已登录的浏览器
- 打开文档进入编辑模式
- 循环 Ctrl+A + Backspace 清空内容
- 逐行输入新内容
飞书 API 配置
租户配置
| 租户 | App ID | 用途 |
|---|---|---|
| hanxing | YOUR_FEISHU_APP_ID | 汉兴企业(默认) |
| personal | cli_a83467f9ecba5013 | 个人应用 |
API 权限
需要的权限范围:
docx:document:readonly- 读取文档docx:document- 编辑文档(API 方式)
优化模板
项目文档模板
# [项目名称]
> [一句话描述]
> 📅 版本:vX.X | 更新日期:YYYY-MM-DD
---
## 📋 目录
1. 项目背景 2. 系统架构 3. 核心功能 ...
---
## 1. 项目背景
### 1.1 痛点分析
🔴 痛点1 - 描述 ⭐⭐⭐⭐⭐
🔴 痛点2 - 描述 ⭐⭐⭐⭐
### 1.2 解决方案
方案描述...
---
## 2. 核心功能
### 2.1 功能名称 ✅
**功能**:功能描述
**流程**:步骤1 ➜ 步骤2 ➜ 步骤3
---
## N. 项目价值
### N.1 投入成本
| 项目 | 成本 | 说明 |
|------|------|------|
| 项目1 | ¥0 | 说明 |
### N.2 产出价值
⏱️ 指标1:描述
💰 指标2:描述
---
💡 如有改进建议,欢迎提出!
格式规范
Emoji 使用
| 场景 | Emoji |
|---|---|
| 目录/导航 | 📋 |
| 日期/版本 | 📅 |
| 痛点/问题 | 🔴 |
| 已完成 | ✅ |
| 进行中 | 🔄 |
| 待办 | ⏳ |
| 重要提示 | ⚠️ 💡 |
| 数据采集 | 📥 |
| 数据处理 | ⚙️ |
| 数据展示 | 📊 |
| 时间 | ⏱️ |
| 成本 | 💰 |
| 增长 | 📈 |
分隔符
- 章节分隔:
---(三个短横线) - 流程箭头:
➜ - 星级评分:
⭐⭐⭐⭐⭐
表格格式
| 列1 | 列2 | 列3 |
|:---:|------|:---:|
| 居中 | 左对齐 | 居中 |
注意事项
- 登录状态:浏览器编辑需要已登录飞书
- API 限制:飞书 API 不支持直接删除文档块
- 编辑模式:确保文档处于"编辑"模式而非"阅读"模式
- 保存确认:编辑后等待"已保存到云端"提示
相关文件
scripts/feishu_doc_reader.py- 读取文档内容scripts/feishu_doc_editor.py- 编辑文档内容references/optimization-examples.md- 优化案例参考