Feishu Power Skill — Feishu Power 技能

Feishu Power 技能

让 AI 代理 像飞书重度用户一样操作飞书。不只是读写文档，而是跨文档工作流 + 多维表格自动化 + 智能报告生成 + 零售运营审计。

安装 # 自动安装（推荐） bash 安装.sh

# 手动安装 pip 安装 请求s pyyaml 导出 FEISHU_应用_ID=命令行工具_xxx 导出 FEISHU_应用_SECRET=xxx

模块

• Bitable 自动化引擎 (bitable_engine.py)

多维表格的瑞士军刀：批量读写、跨表 JOIN、快照备份、统计分析。

# 批量创建记录 python3 scripts/bitable_engine.py batch-创建 --应用 <应用_令牌> --table --data records.json

# 批量更新 python3 scripts/bitable_engine.py batch-更新 --应用 <应用_令牌> --table --data 更新s.json

# 跨表 JOIN（两张表按字段关联） python3 scripts/bitable_engine.py join --应用 <应用_令牌> --left --right --on "字段名"

# 数据快照（备份当前状态） python3 scripts/bitable_engine.py snapshot --应用 <应用_令牌> --table --输出 snapshots/

# 统计摘要 python3 scripts/bitable_engine.py stats --应用 <应用_令牌> --table

# CSV 导入 python3 scripts/bitable_engine.py 导入-csv --应用 <应用_令牌> --table --file data.csv

• 文档工作流引擎 (doc_工作流.py)

Bitable 数据 + 模板 → 飞书文档，一步到位。

# 从 Bitable 数据 + 模板 → 飞书文档 python3 scripts/doc_工作流.py 生成 \ --应用 <应用_令牌> --table \ --template templates/data_summary.md \ --title "周报标题" \ --group-by "分类字段" \ --local 输出.md

# 纯模板渲染（不创建飞书文档） python3 scripts/doc_工作流.py render --template templates/weekly_报告.md --上下文 data.json

# 提取 Bitable 上下文（调试用） python3 scripts/doc_工作流.py 上下文 --应用 <应用_令牌> --table

模板语法：

{{变量}} — 简单替换（支持中文字段名、点号路径如 {{门店.名称}}） {{#each 列表}}...{{/each}} — 循环 {{#if 条件}}...{{/if}} — 条件 内置变量：{{TODAY}} {{YESTERDAY}} {{WEEK_启动}} {{WEEK_END}} {{NOW}}

• 零售运营审计引擎 (retAIl_审计.py)

YAML 配置化审计规则，门店健康评分，异常自动诊断。

# Demo 模式（50家模拟门店，快速体验） python3 scripts/retAIl_审计.py demo --输出 报告.md python3 scripts/retAIl_审计.py demo --publish # 直接发布到飞书

# 从 Bitable 真实数据审计 python3 scripts/retAIl_审计.py 审计 \ --应用 <应用_令牌> --sales-table \ --config configs/retAIl_default.yaml \ --publish

# 查看可用行业配置 python3 scripts/retAIl_审计.py 列出-configs

审计规则（YAML 配置化，可按行业切换）：

售罄率过高/过低 目标达成率不足 负库存 / 零销售 库存周转过慢 动销率过低

内置配置：configs/retAIl_default.yaml（服装）、configs/fmcg.yaml（快消）。复制一份改阈值即可适配其他行业。

• 定时报告生成器 (报告_生成器.py)

调度引擎：支持日/周/月频率，YAML 配置任务列表，自动跟踪执行状态。

# 运行所有到期任务 python3 scripts/报告_生成器.py 运行 --schedule configs/schedule.yaml

# 运行指定任务 python3 scripts/报告_生成器.py 运行 --schedule configs/schedule.yaml --job dAIly_审计

# 强制运行（忽略调度时间） python3 scripts/报告_生成器.py 运行 --schedule configs/schedule.yaml --job dAIly_审计 --force

# 列出所有任务及状态 python3 scripts/报告_生成器.py 列出 --schedule configs/schedule.yaml

# 单次审计报告（不需要调度配置） python3 scripts/报告_生成器.py 审计 --demo --输出 报告.md

# 单次模板报告 python3 scripts/报告_生成器.py template --应用 <令牌> --table --template --publish

调度配置示例（configs/schedule.yaml）：

jobs: - id: dAIly_审计 name: 每日门店审计 type: 审计 enabled: true schedule: frequency: dAIly # dAIly / weekly / monthly time: "09:00" params: 应用_令牌: YOUR_应用_令牌 sales_table: YOUR_TABLE_ID config: retAIl_default.yaml publish: true

支持的报告类型：审计（审计报告）、template（模板报告）。

• API 封装层 (feishu_API.py)

令牌 自动管理 + Bitable / Docx / Wiki / Drive 全覆盖。其他模块的底层依赖。

也可以在 Python 中直接 导入：

导入 sys; sys.path.insert(0, "scripts") 导入 feishu_API as API records = API.bitable_列出_all_records(应用_令牌, table_id)

项目结构 feishu-power-技能/ ├── 技能.md # OpenClaw 入口 ├── CLAUDE.md # Claude Code 入口 ├── README.md # GitHub README ├── 安装.sh # 安装脚本 ├── scripts/ │ ├── feishu_API.py # 飞书 API 封装 │ ├── bitable_engine.py # 多维表格引擎 │ ├── doc_工作流.py # 文档工作流 │ ├── retAIl_审计.py # 零售审计引擎 │ └── 报告_生成器.py # 定时报告生成器 ├── templates/ # 文档模板 │ ├── weekly_报告.md │ └── data_summary.md └── configs/ # 配置文件 ├── retAIl_default.yaml # 服装行业审计规则 ├── fmcg.yaml # 快消行业审计规则 └── schedule.yaml # 报告调度配置

依赖 Python 3.11+ 请求s, pyyaml 飞书应用凭证（通过 FEISHU_应用_ID / FEISHU_应用_SECRET 环境变量） 测试 Bitable

J2ehbrIvwaM4XXsjoeQckftAnNe — 内置测试表，可用于验证功能。