禅道命令行 ZenTao-CLI 发布，自带原厂Skills辅助，让项目管理效率翻倍

你是否希望在AI Agents中直接使用禅道？现在，通过安装禅道CLI即可轻松实现！

禅道推出了全新的ZenTao-CLI工具，它不仅是一个命令行工具，更是连接AI与研发管理数据的桥梁。

通过安装该技能， 可利用AI Agent（如Cursor、Claude Code等）直接查询项目进度、分析Bug风险、甚至自动生成需求文档。CLI技能会利用ZenTao-CLI工具来访问和操作禅道数据，让大模型成为你的研发管理助手。

禅道会持续更新完善禅道API 2.0，逐步覆盖更多模块与场景。

适用版本：开源版21.7.8、企业版12.7、旗舰版7.7、IPD版4.7及以上版本。

温馨提示：我们强烈建议对AI发起的、涉及数据变更的API调用进行最终的人工审核确认，以确保操作意图的准确性。

ZenTao-CLI特色

• 基于最新的禅道RESTful API 2.0实现

• 使用便捷，可通过npx zentao-cli立即运行

• 安全的用户认证管理，支持多用户切换

• 支持对数据进行摘取、过滤、排序等处理，并自动将HTML转换为Markdown

• 对AI Agents友好，帮助信息完善，支持输出Markdown

• 支持以AI技能的方式使用，支持通过zentao add-skill一键安装技能到AI Agent

• 支持MCP服务，使用npx zentao-cli mcp启动MCP服务

• 使用现代的Bun与TypeScript开发，具备类型安全

• 提供完善的测试覆盖，保障代码质量

支持的AI Agents工具

禅道CLI支持在所有支持技能或MCP的Agents工具中使用。为了方便大家选择，我们按照上手难度从易到难列举如下：

新手推荐：

• Cursor（可免费使用）

• VS Code Copilot（可免费使用）

• Cherry Studio（可配置国内模型API，智能体能力稍弱）

开发者推荐：

• Cline（可配置国内模型API）

• OpenClaw（可配置国内模型API）

• OpenCode（可配置国内模型API）

• Claude Code（可配置国内模型API）

进阶/付费推荐：

• Trae（需要付费订阅）

• Codex（需要付费订阅及特殊网络环境）

• Antigravity（需要付费订阅及特殊网络环境）

• Codex CLI（可配置国内模型API）

如何快速开始？

第一步：安装技能

▼现代的Agents工具都支持自动发现安装技能,你可以将如下内容发送给 Agent 来进行安装：

安装https://cn.clawhub-mirror.com/catouse/zentao-cli 技能，并安装技能所需的zentao-cli命令行工具。

开发者安装命令：

▼如果你是开发者，可以直接在终端中执行命令来安装：

# 全局安装 zentao-cli 工具
$ npm install -g zentao-cli
# 其他安装与运行方式
# bun install -g zentao-cli  # ← 使用 bun 安装
# npx zentao-cli             # ← 通过 npx 免安装运行
# pnpm dlx zentao-cli        # ← 通过 pnpm 免安装运行
# 安装完成之后可以一键安装技能到 Agents
$ zentao add-skill
请选择要安装的 AI Agent:
  1) Claude Code
  2) Cursor
  3) Cherry Studio
  4) Codex
  5) OpenCode
  6) VS Code
  7) Antigravity
  8) Gemini
  9) 全部安装
请输入编号 (1-9):9

▼执行后，工具会列出支持的AI Agent列表，输入编号（如9代表全部安装）即可自动完成配置。

第二步：账号登录与鉴权

安装完成后，需要进行一次登录配置。为了账号安全，强烈建议不要将账号密码直接发送给AI Agents，请使用以下本地配置方式。

1.环境变量配置（推荐）：在环境变量中配置禅道 URL、用户名和密码，工具会自动登录并自动续期Token。

export ZENTAO_URL=https://zentao.example.com
export ZENTAO_ACCOUNT=admin
export ZENTAO_PASSWORD=123456

2.命令行登录：也可以使用命令行手动登录：

zentao login -s https://zentao.example.com -u admin -p 123456

第三步：对话与实战

配置完成后，你就可以在对应的 Agent 工具中，像与同事聊天一样使用禅道了，以下是几个实战示例：

• 需求与规划： “我想创建一个产品，用来在线收集用户信息，请帮我整理思路，并生成第一版需求和计划，如果有问题尽管问我。”

• 进度追踪： “上周增加了哪些新的需求？哪些需求比较难？我想针对比较难的需求提前制定方案。”

• 缺陷分析： “BUG 329 是什么问题？可能的原因是什么？有解决方案吗？”

• 风险分析： “迭代10的执行情况如何？有哪些风险？”

升级与维护

▼如果ZenTao-CLI本身或者技能有新版本发布，你可以通过如下命令来升级：

# 升级 CLI 本身
zentao upgrade
# 然后通过 add-skill 命令升级技能
zentao add-skill

▼你也可以直接要求Agent帮你完成升级：

“请帮我升级 zentao-cli，并通过 zentao add-skill 命令重新安装最新的技能。”

常见问题 (FAQ)

Q：这个CLI技能和之前发布的ZenTao-API技能有什么不同？我该用哪个？

A：强烈推荐使用禅道CLI技能。CLI技能封装了复杂的API细节，支持更多功能（如数据过滤、Markdown转换），且更省Token。大模型不需要关注API调用细节，可以更专注于解决真实的问题，而ZenTao-API技能需要大模型处理API细节，容易出错。

Q：我不懂Agents、技能等概念，我该怎么使用？

A：在AI没有接管地球之前，无需着急。目前受限于Agents能力，并不能完全代替禅道GUI使用。建议先从简单的查询开始，或者使用内置的ZenTao-Tour技能，它会通过有趣的方式引导你体验。

Q：可以在禅道AI里面使用吗？

A：目前还不支持在禅道内直接使用CLI功能，但我们正在加速开发ZAI Agents平台，后续将在禅道里面直接支持安装技能。

Q：为什么有些操作（如操作模块、读写文档）无法实现？

A：CLI目前依赖禅道API 2.0，部分接口还在加速完善中，敬请期待后续更新。

持续优化，定期更新，禅道一直在路上！