wecomteam--wecom-cli/AGENTS.md

AI Agent 指引

本文件帮助 AI Agent 快速定位项目关键文件，避免阅读无关代码。

项目概述

wecom-cli 是一个企业微信 CLI 工具（Rust），通过 JSON-RPC 调用远程 MCP 服务。CLI 结构为：

wecom <category> <method>          # 远程工具调用
wecom <category> +<helper_name>    # 本地 helper（+ 前缀）

任务路由

根据任务类型，阅读对应指引文件即可，不需要阅读其他文件：

任务	指引文件	你需要修改的文件
新建/维护现有 helper	src/helpers/AGENTS.md	对应 helper 的 .rs 文件
理解人类的需求格式	src/helpers/HUMANS.md	—

项目结构速查

src/
├── main.rs                # CLI 入口，构建 clap Command
├── json_rpc.rs            # 远程调用：call_tool(category, method, args)
├── fs_util/               # 文件系统工具（atomic_write, sanitize_filename）
├── service/
│   └── handler.rs         # 调度逻辑：helper 优先 → fallback 远程调用
└── helpers/               # ⭐ Helper 子系统（详见 helpers/AGENTS.md）
    ├── mod.rs             # 模块声明
    ├── registry.rs        # Helper trait + HelperRegistry
    ├── AGENTS.md          # AI 实现指南（核心文档）
    └── <category>/        # 按 category 分目录存放 helper

注意事项

• 不要修改 main.rs 和 service/ 下的文件：helper 系统通过 registry 自动注册，无需改动调度层
• 用户的需求描述格式参考 src/helpers/HUMANS.md，除非用户直接声明，否则你无需阅读这篇文档