feishu-setup
This Claude Code skill automates the creation and configuration of a Feishu (Lark) bot application on the Feishu Open Platform by running a full-setup script in the sandbox that handles application creation, permission configuration, event subscription, and publishing. Use this skill when a user requests Feishu bot setup, needs to configure Lark credentials, or requires integration of a Feishu IM application, requiring only QR code authentication from the user.
git clone --depth 1 https://github.com/AgentTeam-TaichuAI/ScienceClaw /tmp/feishu-setup && cp -r /tmp/feishu-setup/ScienceClaw/backend/builtin_skills/feishu-setup ~/.claude/skills/feishu-setupSKILL.md
# Feishu Auto Setup
Automate the creation and configuration of a Feishu (Lark) bot application on the Feishu Open Platform. The user only needs to scan a QR code to log in; all other steps are handled automatically by the one-shot script `feishu_full_setup.py` running in the sandbox.
## Prerequisites
- The sandbox container must be running (provides the built-in browser via MCP).
- The backend service must be reachable from the sandbox at `http://backend:8000`.
## Execution
该 skill 只支持使用总控脚本 `feishu_full_setup.py` 一次性完成全部流程，不再支持单独执行 `feishu_auto_setup.py`。
```bash
python3 /builtin-skills/feishu-setup/scripts/feishu_full_setup.py --name "ScienceClaw 助手"
```
使用 agent 的 `execute` 工具执行上面的总控命令时，必须显式设置 `timeout=900`。不要使用 `timeout=300`，因为飞书页面自动化、扫码等待、权限导入和事件配置可能持续数分钟。
**注意**：总控脚本执行时间较长。若执行过程中遇到超时或失败，不要再单独执行 `feishu_auto_setup.py` 的任一步骤，否则会打乱 `feishu_full_setup.py` 的页面状态与执行顺序。如果检测到执行失败，则等待 3 分钟后退出。如果已经完成到第 7 步骤，可以视为成功。
脚本会自动完成以下步骤：
- 打开飞书开放平台并等待扫码登录
- 创建应用、添加机器人、首次发布
- 获取 `app_id` / `app_secret`
- 回写系统 `LARK_APP_ID` / `LARK_APP_SECRET` 并建立长连接
- 配置应用身份权限
- 配置用户身份权限
- 配置事件与回调
- 第二次发布
如需跳过某些步骤，可使用：
- `--skip-app-permissions`
- `--skip-user-permissions`
- `--skip-step2-publish`
如需在 workspace 中执行，只复制总控脚本即可：
```bash
cp /builtin-skills/feishu-setup/scripts/feishu_full_setup.py {workspace_dir}/feishu_full_setup.py
python3 {workspace_dir}/feishu_full_setup.py --name "ScienceClaw 助手"
```
总控脚本会在同一条命令执行过程中等待用户扫码登录飞书。
如果 `feishu_full_setup.py` 执行失败，则等待 3 分钟后退出, 如果已经完成到第 7 步骤，可以视为成功。You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "above the fold," "this copy is weak," "make this more compelling," or "help me describe my product." Use this whenever someone is working on website text that needs to persuade or convert.
多源深度调研与专业报告生成。适用场景广泛——只要用户的问题涉及需要深度分析的专业话题，就应使用此技能。包括但不限于：(1) 用户明确要求调研/research/综述/报告/发现；(2) 用户提出一个技术或科学话题，话题复杂度需要多源深度分析；(3) 用户要求对比多种技术方案的优劣；(4) 涉及生物医药、蛋白质、基因、药物靶点等需要专业数据库支撑的问题。核心能力：根据问题性质自动组合 arXiv 论文检索 + ToolUniverse 科学工具（UniProt/OpenTargets/PubMed/FAERS 等 1000+ 工具）+ Web 搜索，多源采集数据，交叉分析，生成专业 PDF/DOCX 研究报告。
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.
MANDATORY: When a user asks to install, find, search, or add ANY skill (e.g. 'install hello-world skill', 'find a skill for X', 'add a skill'), you MUST first run `skills find <query>` to search the skills ecosystem. NEVER create a skill from scratch without searching first. Even if the name sounds simple, always search — it may already exist as a published skill.
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
Use this skill any time a .pptx file is involved — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading or extracting text from .pptx files; editing or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions 'deck', 'slides', 'presentation', or references a .pptx filename. If a .pptx file needs to be opened, created, or touched, use this skill.
|