核心用法
禅道-ZenTao 技能为项目管理场景提供统一 API 封装,覆盖用户、项目集、产品、项目、执行、任务、缺陷、版本、用例、反馈、工单等 12 类实体。支持自然语言触发(如“禅道需求列表 产品=IDS”)与英文命令(zentao projects)。
显著优点
- 双 API 兼容:优先 REST API(Token 认证),老 API(Session)兜底,适配不同禅道版本
- 查询即开即用:所有 GET 接口无需确认,秒级响应团队数据需求
- 写操作可控:POST/PUT/DELETE 均标记为“需确认”,防止误操作
- 中文语义友好:支持“禅道”“zentao”等多触发词,降低使用门槛
潜在局限
- 凭证管理依赖本地:需手动维护 TOOLS.md,缺乏 OAuth 等现代授权机制
- 无数据变更审计:操作类接口未内建日志追踪,误删难回溯
- 老 API 稳定性风险:Session 模式在禅道升级时可能失效
- 并发与限流未说明:高频查询可能触发服务端限流,无重试策略
适合人群
- 研发团队 PM、Scrum Master、测试负责人
- 需将禅道数据同步至内部 BI 或周报系统的开发者
- 习惯命令行/自然语言交互的技术管理者
常规风险
- 凭证泄露:明文存储用户名密码于 TOOLS.md,若误提交至 Git 可导致数据泄露
- 误操作数据:写操作虽需确认,但批量删除(如项目/产品级联删除)影响面大
- 权限边界模糊:技能未细粒度校验禅道角色权限,超权查询可能失败或返回空数据