核心用法
zentao-api 技能通过 RESTful API v2.0 与禅道（ZenTao）项目管理平台深度集成，支持完整的 CRUD 操作：
- 数据查询：获取项目/产品列表、执行（迭代/Sprint）、Bug、需求（Story）、任务、测试用例、用户等信息
- 状态管理：解决 Bug、关闭需求、完成任务等状态流转操作
- 内容创建：新建需求、任务、Bug 等项目资产
- 数据更新：修改现有资源的标题、优先级、指派等字段
技能采用 Token 缓存机制避免重复登录，首次配置后自动持久化认证信息至 ~/.zentao-token.json，后续调用零交互。
显著优点
1. 自动化研发流程：无需打开禅道 Web 界面，通过自然语言指令即可完成日常项目管理操作
2. 上下文智能：支持意图识别，自动匹配关键词到对应 API 端点（如"解决 Bug"→PUT /bugs/{id}/resolve）
3. 安全确认机制：写操作前向用户确认，防止误操作；支持强制跳过确认模式
4. 数据完整性保障：PUT 操作自动调用 GET 回填缺失字段，避免因部分字段更新导致的数据覆盖
潜在缺点与局限性
- ID 依赖：多数操作需要预先知道数字 ID，无法通过名称直接操作，需先查询列表
- 版本兼容性：基于 API v2.0，部分旧版禅道可能需要降级至 v1.0
- 字段不透明：API 字段与 Web 界面不完全一致，某些业务字段可能缺失或命名不同
- 网络依赖：纯 API 调用模式，离线场景无法使用
适合人群
- 研发团队负责人、项目经理、Scrum Master
- 需要批量处理 Bug/任务/需求的测试/开发人员
- 希望将禅道数据接入自动化工作流的技术团队
常规风险
- Token 泄露：缓存文件
~/.zentao-token.json包含长期有效凭证，需确保文件权限安全（建议 600） - 误操作风险：批量修改或删除操作可能造成不可逆数据变更，务必确认写操作内容
- 权限边界：技能不校验禅道内部权限，实际可操作范围受限于 API Token 所属账号的禅道角色权限
- 数据一致性：并发编辑场景下可能存在覆盖风险，建议避免高频自动化写操作