feat: v2 — 飞书全能集成套件 (CLI + MCP Integration Kit)#4
Conversation
Transform feishu-mcp from MCP-only tool into a comprehensive integration kit combining Feishu CLI (200+ commands, 19 skills) with community MCP (15 doc editing tools) for non-technical users. New deliverables: - setup-v2.sh: smart setup script with CLI + MCP install, OpenClaw detection - SKILL.md: 544-line decision matrix (49 intents → tool routing) - AGENTS.md: 749-line master agent reference with decision tree - QUICKSTART-AGENT.md: 9-step automated setup guide for AI agents - TROUBLESHOOT-AGENT.md: 17 error entries with recovery procedures - GUIDE.md: step-by-step visual setup guide for non-technical users - 3 platform config templates (OpenClaw, Claude Code, Cursor) - 5 workflow skills demonstrating CLI + MCP synergy Architecture: two-layer (CLI for breadth, community MCP for depth). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0e21fe5a40
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| # ============================================================ | ||
|
|
||
| SETUP_VERSION="2.0.0" | ||
| SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" |
There was a problem hiding this comment.
Handle stdin execution when resolving SCRIPT_DIR
The setup flow is documented to run as curl .../setup-v2.sh | bash, but in that execution mode $0 is bash, so SCRIPT_DIR resolves to the caller’s current directory rather than the repository/script location. Later steps read templates from ${SCRIPT_DIR}/configs/*.json to generate Claude/Cursor/OpenClaw configs, which will be missing for piped installs, so users following the documented install path won’t get platform config generation.
Useful? React with 👍 / 👎.
| if stty -echo 2>/dev/null; then | ||
| read -r APP_SECRET | ||
| stty echo |
There was a problem hiding this comment.
Ensure terminal echo is restored on secret prompt abort
The secret prompt disables terminal echo with stty -echo, but if read is interrupted (for example, user presses Ctrl+C) the script exits before stty echo runs, leaving the user’s terminal in no-echo mode for subsequent commands. This is an interactive reliability issue and is especially visible during manual setup when users cancel at the secret entry step.
Useful? React with 👍 / 👎.
Summary
将 feishu-mcp 从 MCP-only 工具转型为飞书全能集成套件 — 让飞书 CLI(200+ 命令、19 个 AI Skills)和社区 MCP(15 个文档编辑工具)作为统一系统工作的集成层。
核心定位
新增内容(+4726 行,16 个文件)
安装自动化
setup-v2.sh— 智能安装脚本:一条命令安装 CLI + MCP + OpenClaw 检测configs/— 3 个平台配置模板(OpenClaw / Claude Code / Cursor)AI Agent 文档
SKILL.md— 544 行决策矩阵(49 个意图 → 工具路由)AGENTS.md— 749 行 Agent 操作手册 + 15 入口决策树 + 39 个命令示例QUICKSTART-AGENT.md— 9 步自动安装流程TROUBLESHOOT-AGENT.md— 17 个错误条目 + 恢复步骤用户文档
README.md— 重写为非技术用户视角GUIDE.md— 从零开始 7 步配置指南 + 10 个示例对话工作流 Skill
skills/feishu-overview.md— 能力总览索引skills/doc-review.md— 文档审阅(MCP 读 → CLI 建任务 → CLI 发群)skills/data-to-doc.md— 数据报告(CLI 查表 → MCP 生成格式化文档)skills/knowledge-sync.md— 知识同步(Wiki ↔ 文档双向)skills/meeting-summary-plus.md— 增强会议纪要开发方法
使用 Planner → Builder → QA 三角色 harness:
Test plan
setup-v2.sh,验证 CLI 安装和 authnpx skills add正确识别