用途：本技能是 zentao-cli 的共享规则，指导如何通过 zentao-cli 操作禅道（ZenTao）资源及注意事项。
配置初始化：当用户未配置或认证失败时，先运行 zentao-cli auth status 检测状态；若返回 ZEN_AUTH_FAILED 或 ZEN_CONFIG_INVALID，说明未配置或配置无效。需向用户询问禅道服务地址、账号、密码，以及保存位置（全局 ~/.zentao-cli/config.toml 或当前项目 .zentao-cli/config.toml），必须等用户明确选择后才能执行配置。全局保存使用 zentao-cli config set -g url "地址" 与 zentao-cli auth login -g --account 账号 --password 密码；项目保存去掉 -g。注意 config set 仅支持 url、token、product_id、project_id，账号密码须通过 auth login 获取 token。
认证：采用 Token 认证，通过 ZENTAO_TOKEN 环境变量传递。环境变量包括 ZENTAO_URL（必需）、ZENTAO_TOKEN（必需）、ZENTAO_PRODUCT_ID、ZENTAO_PROJECT_ID（可选）。也可登录 Web 界面在个人设置 → API Token 手动生成。
错误处理：常见错误码有 ZEN_AUTH_FAILED、ZEN_NOT_FOUND、ZEN_CONFIG_INVALID、ZEN_API_ERROR、ZEN_PARAM_MISSING。权限不足时确认用户角色、Token 权限及项目/产品分配。
配置优先级：命令行参数 > 环境变量 > 默认配置。通用选项含 --format（json、pretty、table、ndjson、csv）、--product、--project、--status。
更新检查：命令输出若含 _notice.update 字段，应告知版本并提议执行 npm update -g zentao-cli && npx skills add zentao/cli -g -y，并提醒重启 AI Agent。
安全规则：禁止明文输出 token、appSecret；写入/删除前确认用户意图；用 --dry-run 预览危险请求。