核心用法
dingtalk-calendar 是一个纯文档型的 Agent Skill，通过 mcporter CLI 工具桥接钉钉官方 MCP 服务，实现企业日历管理的自动化操作。用户需先安装 mcporter CLI 并配置钉钉日历、钉钉通讯录两个 MCP 服务端点，即可通过标准化命令完成日程创建、查询、修改、删除，以及会议室预订、闲忙状态查询等核心功能。
典型 workflow 包括：搜索通讯录获取用户 ID → 查询空闲会议室 → 创建日程并指定参会人 → 为日程绑定会议室 → 会前查询参会人闲忙状态。所有操作均通过 mcporter call <service> <tool> 模式执行，参数支持 ISO-8601 时间格式与 Unix 毫秒时间戳互转。
显著优点
企业级生态整合：深度对接钉钉日历与通讯录，直接复用企业组织架构，无需额外维护用户体系，参会人、会议室资源与钉钉后台实时同步。
零代码安全架构：Skill 本身为纯 Markdown 文档，无可执行代码，所有敏感操作由钉钉官方 MCP 服务端处理，天然规避代码注入与数据泄露风险。
标准化 CLI 体验：统一使用 mcporter 作为调用入口，命令语法一致，支持 JSON 输出便于程序化解析，适合集成到自动化脚本或 CI/CD 流程。
会议室资源智能调度：原生支持空闲会议室查询与自动绑定，解决传统企业"订会容易订室难"的痛点。
潜在缺点与局限性
前置依赖较重：需独立安装 mcporter CLI 并完成两处 MCP 服务配置，对非技术用户门槛较高；Windows 环境需额外配置终端工具。
时间格式混用：创建日程使用 ISO-8601 字符串，而查询类接口使用 Unix 毫秒时间戳，同一 Skill 内存在两种时间标准，增加心智负担。
功能边界受限：作为 MCP 客户端封装层，核心能力受限于钉钉 MCP 服务本身，如不支持循环日程、外部嘉宾邀请、会议录制关联等高级功能。
网络与权限依赖：严格依赖钉钉企业账号权限体系，若用户无日历/会议室管理权限或企业未开通相关模块，功能将不可用。
适合的目标群体
- 企业行政与会议组织者：需要批量管理会议室、协调多人日程的行政人员
- 研发团队技术负责人：习惯命令行操作、希望将会议管理集成到开发工作流的工程师
- 钉钉生态深度用户：已全面使用钉钉进行办公协作、追求工具链统一性的中小企业
- 自动化运维场景：需要将会议创建纳入自动化流程（如项目管理系统触发立项会）的 DevOps 团队
常规使用风险
mcporter 工具链风险：Skill 本身安全，但实际执行依赖 mcporter CLI。若 mcporter 出现漏洞版本或从非官方渠道安装，可能引入供应链风险。建议锁定版本并通过 npm/bun 官方源安装。
凭证配置泄露风险：MCP 服务端点 URL 包含访问凭证，若以明文形式存储在共享环境或未加密的配置文件中，可能导致企业日历数据被非法访问。
权限过度配置隐患：按文档配置时易使用高权限账号，建议遵循最小权限原则，为不同使用场景创建专用钉钉应用并限制可见范围。
API 稳定性与限流：依赖钉钉 MCP 服务可用性，若钉钉服务端升级或调整接口，可能导致功能中断；高频调用需关注钉钉官方限流策略。