用途：该技能用于通过禅道 RESTful API v2.0 完成用户请求，覆盖项目管理中的多种资源与操作。
主要能力：支持项目集、产品、项目、执行、需求（Story/Epic/Requirement）、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、文件等模块。列表接口统一支持 browseType 或 status 筛选、orderBy 排序、recPerPage 分页（最大1000）和 pageID 页码。部分资源支持状态流转操作，如需求的 change/close/activate、Bug 的 resolve/close/activate、任务的 start/finish/close/activate 等。API 基础路径为 $ZENTAO_URL/api.php/v2。
使用方式：需配置 ZENTAO_URL、ZENTAO_TOKEN、ZENTAO_ACCOUNT、ZENTAO_PASSWORD 等变量，优先级从高到低。所有业务 API 需在 Header 携带 token。可运行 scripts/get-token.sh 自动获取凭证，脚本依赖 curl 和 node，执行 eval "$(bash scripts/get-token.sh)" 后可直接使用 $ZENTAO_URL、$ZENTAO_TOKEN、$ZENTAO_ACCOUNT。
操作流程：获取凭证后，根据用户意图选择正确端点；PUT 编辑操作若必填字段不全，先 GET 详情取回当前数据再覆盖；构造请求并向用户确认写操作；执行并解析响应，以清晰格式展示结果。
限制与注意：URL 中的 {id} 需替换实际 ID，不知 ID 时先调列表接口。创建 Epic/Requirement/Story 建议显式传 grade，避免层级写成 0 导致标签异常。状态流转操作通常有独立必填字段，无需先 GET。写操作前向用户确认。401 表示 token 失效，可删除 ~/.zentao-token.json 重新获取。注意字段名差异：POST builds 用 executionID，PUT builds 用 execution；PUT testcases 的模块字段为 moudule。详细端点、必填/可选字段、枚举值和查询参数见 api-reference.md，官方文档为 https://www.zentao.net/book/api/2309.html。