核心用法
ZenTao Skill 是一款专为禅道项目管理软件设计的 API 集成工具，同时支持 REST API（Token 认证）和 Legacy API（Session/Cookie 认证）两种模式。用户需在 TOOLS.md 文件中配置 API 地址、用户名和密码后方可使用。
功能覆盖
- 查询类操作（无需确认）：用户、项目集、产品、项目、执行、任务、缺陷、版本、测试用例、反馈、工单等 50+ 查询接口
- 操作类操作（需用户确认）：创建/修改/删除用户、产品、项目、需求、任务、缺陷、测试用例等全生命周期管理
典型指令示例
禅道产品列表 禅道项目状态=进行中 禅道任务列表 执行=迭代1 禅道新建需求 产品=XX系统 标题=【新功能】XXX
显著优点
1. 双语支持完善：中英文文档齐全，指令同时支持中英文关键词
2. 双 API 兼容：自动优先使用 REST API，无缝降级至 Legacy API
3. 操作安全设计：所有写入操作强制要求用户确认，防止误操作
4. 智能参数识别：支持 ID 与名称混用（如 产品=21 或 产品=XX系统）
潜在缺点与局限性
1. 凭证管理繁琐：需手动编辑 TOOLS.md 文件，无图形化配置界面
2. 网络依赖性强：依赖企业内网 ZenTao 实例，公网访问需额外配置
3. 数据量限制：官方建议单次查询不超过 1 年历史数据
4. 权限耦合：API 返回结果受 ZenTao 账号权限严格限制
适合人群
- 使用禅道作为项目管理工具的敏捷团队
- 需要批量查询/导出项目数据的 Scrum Master/项目经理
- 希望通过自然语言快速检索任务状态的开发人员
常规风险
- 凭证泄露风险：TOOLS.md 需手动排除在版本控制外
- 误操作风险：虽有确认机制，但批量删除仍需谨慎
- API 变更风险：禅道版本升级可能导致接口不兼容
- 数据一致性：缓存机制可能导致短时间数据不一致