move claude-marketplace to ai-proj-helper

2026-03-12 21:42:30 +08:00
parent d7b6835e1d
commit 43585b8504
188 changed files with 39510 additions and 0 deletions
--- a/plugins/feishu-plugin/skills/SKILL.md
+++ b/plugins/feishu-plugin/skills/SKILL.md
@@ -0,0 +1,139 @@
+---
+name: feishu
+description: 飞书文档与多维表格操作入口。当用户提到飞书、云文档、多维表格、Bitable 相关任务时自动激活。
+---
+
+# 飞书集成
+
+## 功能模块
+
+| 模块 | 技能 | 说明 |
+|------|------|------|
+| 云文档 | `feishu-docx` | 创建、编辑云文档，会议纪要 |
+| 多维表格 | `feishu-bitable` | 记录增删改查，数据同步 |
+| 任务 | 本技能 | 创建待办任务 |
+
+## 环境配置
+
+```bash
+# ~/.zshrc（凭证唯一配置位置）
+export FEISHU_APP_ID="cli_a9f29dca82b9dbef"
+export FEISHU_APP_SECRET="<从飞书开放平台获取>"
+```
+
+**权限要求**：
+- 云文档：`docx:document`, `drive:drive`
+- 多维表格：`bitable:app`
+- 任务：`task:task:write`
+
+## Access Token
+
+```python
+import os, requests
+
+def get_tenant_access_token():
+    """获取飞书 tenant_access_token"""
+    url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
+    response = requests.post(url, json={
+        "app_id": os.environ["FEISHU_APP_ID"],
+        "app_secret": os.environ["FEISHU_APP_SECRET"]
+    })
+    data = response.json()
+    if data.get("code") == 0:
+        return data["tenant_access_token"]
+    raise Exception(f"获取 token 失败: {data}")
+```
+
+## 默认存储位置
+
+| 文件夹 | folder_token |
+|--------|-------------|
+| ai-proj 根目录 | `RTLKf247ClQQDyd5IjxcTOVQnxd` |
+| 01运营 (默认) | `C80gfkRnzlonQ5d4AhOcOACDnNg` |
+
+## URL 结构
+
+```
+云文档: https://xxx.feishu.cn/docx/DoxcXXXXXX
+                                   └── document_id
+
+多维表格: https://xxx.feishu.cn/base/BascXXX?table=tblXXX&view=vewXXX
+                                      └── app_token  └── table_id
+```
+
+## 飞书任务
+
+```python
+def create_task(summary: str, due_time: int = None):
+    """创建飞书任务"""
+    url = "https://open.feishu.cn/open-apis/task/v2/tasks"
+    token = get_tenant_access_token()
+    payload = {"summary": summary}
+    if due_time:
+        payload["due"] = {"timestamp": str(due_time), "is_all_day": False}
+    response = requests.post(url,
+        headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
+        json=payload)
+    data = response.json()
+    if data.get("code") == 0:
+        return data["data"]["task"]
+    raise Exception(f"创建任务失败: {data}")
+```
+
+## 工具类
+
+完整工具类见：
+- `~/.claude/skills/feishu/feishu_bitable.py` - 多维表格
+- `~/.claude/skills/feishu/feishu_docx.py` - 云文档
+
+## Incoming Webhook（群机器人通知卡片）
+
+**Webhook 地址**：存储在 `~/.config/devops/credentials.env` → `FEISHU_DEPLOY_WEBHOOK`
+
+**⚠️ 关键注意事项**：
+- ❌ **禁用 schema 2.0**：`"schema": "2.0"` 会返回 ErrCode 11246，必须用 legacy 格式
+- ✅ **legacy 卡片格式**（无 schema 字段）才能正常发送
+- ❌ **按钮 URL 禁止指向列表页**：必须带具体资源 ID（如 `/requirements/864`，不能是 `/requirements`）
+- ✅ **保存到文件再 curl**：包含中文的 JSON 直接用 `'...'` 传参会报 "blank argument" 错误
+
+**正确的卡片发送示例**：
+```bash
+cat > /tmp/feishu_card.json << 'EOF'
+{
+  "msg_type": "interactive",
+  "card": {
+    "header": {
+      "title": {"tag": "plain_text", "content": "通知标题"},
+      "template": "blue"
+    },
+    "elements": [
+      {
+        "tag": "div",
+        "text": {"tag": "lark_md", "content": "**内容**：描述文字"}
+      },
+      {
+        "tag": "action",
+        "actions": [{
+          "tag": "button",
+          "text": {"tag": "plain_text", "content": "查看详情"},
+          "type": "primary",
+          "url": "https://ai.pipexerp.com/requirements/864"
+        }]
+      }
+    ]
+  }
+}
+EOF
+
+curl -s -X POST \
+  "https://open.feishu.cn/open-apis/bot/v2/hook/xxx" \
+  -H "Content-Type: application/json" \
+  -d @/tmp/feishu_card.json
+```
+
+**header template 颜色**：`blue`（待审批）/ `green`（通过）/ `red`（驳回）/ `wathet`（信息）
+
+## 相关技能
+
+- `feishu-docx` - 云文档详细操作
+- `feishu-bitable` - 多维表格详细操作