核心用法
禅道技能整合老API与REST API双模式，提供统一的项目管理接口。查询类操作无需确认，涵盖用户、项目集、产品、项目、执行、任务、缺陷、版本、用例、测试单、反馈、工单等全维度数据；操作类（增删改）需用户二次确认。支持自然语言命令如"禅道产品列表""查询禅道需求 产品=IDS"等，降低使用门槛。
显著优点
1. 双API兼容：REST API优先用于用户/产品/项目等基础数据，老API兼容需求/任务/缺陷等复杂场景，覆盖禅道全功能
2. 权限分级设计：查询操作直通，写操作强制确认，避免误操作风险
3. 中文原生支持：触发词和命令均为中文优化，贴合国内研发团队习惯
4. 凭证隔离管理：API配置独立存储于TOOLS.md，与代码版本控制分离
潜在局限
- 依赖自建服务：需用户自行部署禅道系统并开放API，公有云SaaS支持有限
- 老API稳定性：Session认证模式存在过期风险，需自动续期机制
- 数据量限制：官方建议单次查询不超过1年数据，大数据量场景需分页处理
- 写操作确认流程：批量操作场景下频繁确认可能影响效率
适合人群
- 使用禅道作为项目管理工具的研发团队
- 需要将项目数据接入AI工作流的技术负责人
- 追求"对话即操作"敏捷协作的DevOps团队
常规风险
1. 凭证泄露：TOOLS.md若误提交至Git仓库，可能导致API凭证暴露
2. 误操作数据：写操作虽需确认，但复杂条件解析错误可能引发非预期修改
3. API版本差异：禅道社区版/企业版API存在功能差异，部分接口可能不可用
4. 网络边界风险：内网部署的禅道需配置代理或VPN方可外部访问