AI Highlights
AI 亮点
Claude Code 不用只待在终端。在飞书里直接唤起它，结果发回聊天窗口。AI 在本地仓库里跑代码、改文件，你在飞书里看进度、收结果。
入口
飞书里用 Claude Code
用户在飞书聊天里发送自然语言消息，系统把 chatId、本地目录和 Claude session 关联起来，AI 在真实项目里执行命令、修改代码，结果以消息或卡片形式发回聊天窗口。
飞书入口：用户在聊天或菜单卡片里发起请求。
上下文绑定：系统关联 chatId、本地目录和 Claude session。
AI 执行：Claude Code 分析代码、运行命令、读取 skills。
飞书回传：结果发回聊天窗口，团队在飞书里就能看到。
痛点
这个项目解决了什么问题
原来怎么做的
必须守在终端前等 Claude Code 跑完。
飞书和代码仓库各管各的，分析结果传不到团队里。
服务报错靠人工发现，复制日志再切回本地分析。
现在怎么做
飞书里随时问、随时改，手机也能跟进。
AI 在绑定的真实目录里工作，改的是本地代码。
后台错误自动触发分析，结果直接发回飞书。
自动化
后台自动化
Web Monitor 注册 traceback URL 后，后台持续轮询日志变化。发现新错误时，自动触发 Claude Code 分析根因、生成修复方案，按配置执行修复或创建 PR，结果发回飞书。
错误自己找上来，不用等人发现。
分析、修复、验证、回传形成闭环。
结果沉淀在飞书，团队可见。
Capabilities
AI 能做什么
仓库级 Coding Agent
Claude Code 不只是生成文本。它能进入指定目录，运行命令、读取文件、修改代码、执行测试。
src/trigger/invoker.ts
飞书 Tool Use
Claude 按需调用消息、文档、日历、表格、任务、云盘等飞书能力，把分析结果写回协作工具。
oh-my-feishu-plugin/skills/lark-chat-guide/SKILL.md
上下文持续
把飞书会话、本地目录和 Claude session 绑定。换设备也能继续之前的工作，不需要重新解释背景。
src/feishu/interactions/session-store.ts
流式可见
Claude 的流式输出被转成飞书卡片实时更新。长任务有进度感，不会让人觉得"卡住了"。
src/feishu/card-kit.ts
事件驱动
Web Monitor 轮询 traceback，发现新错误后自动触发 Claude 分析或修复。AI 从被动问答变成主动响应。
src/gateway/features/web-monitor/feature.ts
安全确认
自动修复前先分析、再确认、再执行。skills 约束修改范围，超限则阻断并要求人工介入。
workspace/.claude/skills/web-monitor-auto-repair/SKILL.md
Skills
飞书能力接入
项目把飞书能力拆成多个业务域 skill。Claude 不需要一次性记住所有 API，而是在用户请求进入某个场景时读取对应 skill。
即时通讯：发消息、回复、搜索聊天、管理群成员、处理聊天中的图片和文件。
云文档：创建、读取、局部拉取、编辑、插入图片和搜索云空间文档。
电子表格：读写单元格、管理工作表、处理表格数据。
多维表格：表、字段、记录、视图、仪表盘、表单和数据分析。
日历日程：创建会议、查日程、查忙闲、管理参会人和会议室。
云盘：上传下载、导入本地文件、管理文件夹、权限、评论和标题。
任务：创建任务、查看任务列表、管理任务状态。
知识库：空间、成员、节点层级和知识库文档组织。
视频会议与妙记：查询会议记录、获取会议纪要、下载转录内容。
邮箱：起草、发送、回复、转发、搜索邮件和管理草稿。
画板和幻灯片：可视化表达结构、生成演示内容。
组合工作流：会议纪要汇总、日程待办摘要等跨域任务。
Auto Repair
自动修复机制
Web Monitor 不是简单让 AI 自由改代码，而是把服务管理、只读分析、自动修复、安全检查和结果通知拆成清晰的协议。
输入从哪里来
Gateway 触发时传入服务名、GitHub 仓库、traceback URL、本地仓库路径和 PR 配置。
SERVICE_NAME、TARGET_REPO_PATH、TRACEBACK_URL、WEB_MONITOR_AUTO_PR 等作为兜底输入。
必要时读取 .claude/triggers/latest.json 或 workspace/.claude/triggers/latest.json。
执行顺序
确认服务、目标仓库、错误类型和受影响文件。
读取 traceback URL、日志文件或内联错误文本。
定位根因，判断最小修复点。
生成聚焦、可解释的最小变更。
检查路径、diff 规模、密钥和测试要求。
应用改动并运行最相关验证命令。
保留本地修复，按配置决定是否创建 PR，并把结果交回 Gateway。
安全边界
只能修改 TARGET_REPO_PATH / localRepoPath 内的文件。
超过 10 个文件或 500 行时停止，要求人工介入。
修改后必须运行可发现的最相关验证命令。
不能写入 token、password、secret、api_key 等敏感信息。
除非 WEB_MONITOR_AUTO_PR=true，否则不 push、不创建 PR。
Safety
安全边界与分工
安全边界
项目没有把权限全交给 AI，而是把复杂分析交给 Agent，把授权、确认和审核留给人。
PathGuard：只能修改指定目录内的文件。
DiffGuard：超过 10 个文件或 500 行时停止。
TestGuard：修改后必须运行验证命令。
No Secrets：不能写入敏感信息。
No Auto Push：默认不自动推送代码。
谁负责什么
人：授权飞书、选择目录、提出目标、确认修复、审核改动。
AI：理解请求，分析代码和日志，调用工具，生成修复方案。
系统：消息路由、状态保存、会话恢复、事件分发、结果回传。
Reusable
这些设计还能复用
Plugin 化
飞书能力以 Claude plugin 和 skills 形式沉淀，可安装到其他项目。
Feature 化
Gateway 把触发、执行、回传拆开，方便扩展日报、CI 修复等任务。
Skill 协议
不同任务用不同 skill 描述边界，降低 AI 调用工具时的随意性。
真实链路
CLI 引导、菜单、会话绑定、Web Monitor 都是能操作的入口，不是概念图。