企微智能表格 Webhook

这个仓库不教 AI “猜字段”。
它教 AI 在真实页面里登录、验证、阻断、推送，并在不确定时停下来。

什么在这里

仓库气质

这个仓库遵循的是“执行型 skill”思路，而不是“说明书型 skill”思路：

• 主 SKILL.md 短、硬约束、强默认流程
• 细节下沉到按需参考文件
• 复杂可靠性放进脚本，而不是堆进 prompt
• 默认 fail-closed 当前表不明确、webhook 不明确、schema drift、字段不支持时，一律优先阻断

快速安装

npx wecom-skills-installer -t cx -y

本地仓库调试安装仍可直接运行：

npx /Volumes/Work/code/企业微信智能文档webhook推送 -t cx -y

安装后位置：

~/.codex/skills/wecom-smartsheet-webhook

要让 Codex 立即识别新 skill，请重启 Codex。

真实环境最短路径

doctor -> login / fetch -> dry-run -> write

最常用命令：

cd wecom-smartsheet-webhook

npm run doctor -- --json
npm run login -- --url '<智能表格链接>'
npm run fetch -- --url '<智能表格链接>'
npm run sync -- --url '<智能表格链接>' --dry-run

这个 Skill 会替你守住什么

关键运行态状态

这些字段是给 Agent 读的，不是装饰：

• loginPath cookie_header | session_cache | quick_login | qr_terminal | qr_gui
• tableResolutionState resolved | page_not_ready | active_table_not_found | ambiguous_active_table | requested_table_not_found
• webhookResolutionState explicit | bound_table_webhook | bound_doc_webhook | current_table_webhook_missing | ambiguous_current_table_webhook | webhook_unresolved
• blockingCodes 机器可读阻断码，用来区分“安全阻断”与“脚本异常”

维护命令

仓库根：

npm run check
npm run fmt

skill 目录：

cd wecom-smartsheet-webhook

npm run check
npm run fmt
npm run setup

已验证能力

• 复用缓存登录
• 强制二维码 GUI 登录
• 当前激活工作表识别
• 文档级 / 表级 webhook 安全解析
• guard 生成与 drift 阻断
• 真实新增并回读验证
• 真实更新闭环并回读验证

适合谁

• 给 Codex / Claude Code / Gemini CLI 用的执行型 skill 构建者
• 需要把企业微信智能表格纳入 AI 工作流的人
• 不接受“猜一猜字段、试一试 webhook”的团队