Repos / ai-guru-global / beidiao-skills OWN

beidiao-skills

beidiao-skills

在 GitHub 查看 ↗

beidiao-skills

Detective Cao 的 Agent 技能集 —— 企业微信全家的 CLI 技能（wecomcli-*）+ 微信读书（weread），共 16 个技能，遵循 agentskills.io 开放规范与渐进披露预算（SKILL.md ≤500 行 / ≤5k tokens，细节下沉 references/）。

技能矩阵

技能 版本 功能 触发场景（用户会这样说）
wecomcli-shared 1.0.0 wecom-cli 公共前置：安装/版本/扫码授权检查、ID 不外露约束、whoami 所有 wecomcli-* 技能执行前的强制前置
wecomcli-calendar 1.1.0 日程：创建/查看/搜索/更新/取消、忙闲、会议室与办公楼 "约个日程""明天有什么安排""订个会议室"
wecomcli-meeting 1.1.0 在线会议：创建/列表/搜索/更新/取消、纪要待办、逐字转写原文 "开个视频会议""总结下昨天的会""把会上原话发我"
wecomcli-email 2.1.0 邮件：发送/回复/转发/搜索/详情（附件、内嵌图片）、邮件版日程邀约 "搜下合同邮件""回复收到""用邮箱发会议邀请"
wecomcli-message 1.0.0 消息：查询可发送会话范围，向单聊/群发文本、Markdown、图片、文件、音视频 "在项目群里通知一下""把 PDF 发到那个群"
wecomcli-doc 1.0.0 在线 Word：新建/导入/读取/追加/覆盖写入（含 build_docx.py 结构化生成） "读一下这个 doc 链接""往文档里追加一段"
wecomcli-sheet 1.0.0 在线表格：新建/导入 CSV·Excel/读写数据/子表管理 "读取这个 sheet 链接""把 CSV 导入成表格"
wecomcli-smartsheet 1.0.0 智能表格：子表/字段/记录/视图/图表 CRUD、样式高亮、851003 Webhook 兜底 "建个任务跟踪表""把逾期行标红"
wecomcli-smartpage 1.0.0 智能文档：页面树、Block 编辑、MDX、公式、数据驱动页面 "把结论整理成文档"（未指明类型的默认载体）
wecomcli-slide 0.1.0 在线幻灯片：结构读取、形状/动画摘要、布局/JSX 增页、删页、DESIGN.md 设计门、图片上传 "看看这个 PPT 几页""在企微文档里做份 PPT"
wecomcli-disk 1.1.0 微盘：列出/搜索/元信息/上传/下载/重命名/新建文件夹，在线/离线类型路由 "微盘搜一下合同""下载微盘那个文件"
wecomcli-doc-manage 1.0.0 文档公共管理：浏览历史搜索、改名、成员权限、加入规则 "我最近看过哪些文档""把王五加成协作者"
wecomcli-contact 1.0.0 通讯录：按姓名/拼音/英文名/别名搜索，同名全列，userid 解析 "找一下张伟""Tony Wang 是谁"
wecomcli-media 1.0.0 媒体搬运：media_id ⇄ 本地文件（不做内容解析） "把消息里那张图存到本地"
wecomcli-todo 1.0.0 待办：创建/完成/删除/查询/筛选、参与人与截止时间 "提醒我周五前交总结"
weread 1.0.4 微信读书：搜书、书籍详情、书架、笔记划线、热门划线、书评、阅读统计、荐书（Agent API Gateway） "微信读书搜下三体""这个月读了多久"

weread 的 metadata.version 与服务端契约耦合（请求须上报 skill_version），不随仓库发布单独递增。

安装

方式一：npx skills（推荐，自动探测 75+ agent）

npx skills add ai-guru-global/beidiao-skills
# 只装单个技能：
npx skills add ai-guru-global/beidiao-skills --skill wecomcli-meeting

方式二：本仓库安装器（符号链接，git pull 即更新）

git clone https://github.com/ai-guru-global/beidiao-skills.git
cd beidiao-skills && ./scripts/install.sh            # 装到 ~/.agents/skills
./scripts/install.sh --dest ~/.claude/skills         # 或指定目录
./scripts/install.sh --remove                        # 卸载

方式三：Claude Code 插件市场

/plugin marketplace add ai-guru-global/beidiao-skills
/plugin install beidiao-skills@beidiao-skills

依赖：wecomcli-* 需要 wecom-cli ≥1.1.0（npm i -g @wecom/cli）与企业微信扫码授权；weread 需要环境变量 WEREAD_API_KEY。

工程标准

  • 规范：agentskills.io 开放规范（frontmatter 契约 / 命名 / 预算），细则见 docs/standards.md。
  • 校验：python3 scripts/validate.py --strict —— frontmatter、目录命名、≤500 行 / ≤5k tokens 预算、引用文件存在性、evals 结构、反模式（绝对路径 / 角色扮演开头 / http 链接）。CI 在 .github/workflows/ci.yml 强制执行。
  • 评测：每技能 evals/evals.json（行为用例，带 assertions）+ evals/eval-queries.json（触发/消歧查询，含近似误命中负例）。
  • 版本：每技能 metadata.version 独立 semver，变更记录于 CHANGELOG.md。

安全与声明

技能会驱动真实的企业微信账号执行操作（发消息、建会议、写文档）。安装第三方技能前请审计其指令与脚本；本仓库的技能约定：内部 ID 不外露、错误原样转达、不可逆操作（删页/取消）先向用户复述确认。

声明：本仓库为独立社区开源项目（MIT），基于 wecom-cli 与微信读书 Agent API Gateway 公开接口实测构建，与腾讯/微信读书官方无隶属关系，未获其背书；"企业微信""腾讯文档""微信读书"名称仅用于兼容性说明。

GTM / 营销

市场定位、6 条产品叙事、信息矩阵、发布计划、增长与变现路径见 gtm/（从 定位 与 叙事库 读起，可直接发布的文案包与演示剧本在 gtm/assets/）。

License

MIT