禅道CLI 分享链接/book/zentaopms/2377.html?releaseID=26

你是否希望在AI Agents中直接使用禅道？现在，通过安装禅道CLI即可轻松实现。 禅道推出了全新的ZenTao-CLI工具，它不仅是一个命令行工具，更是连接AI与研发管理数据的桥梁。

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

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 的执行情况如何？有哪些风险？”

升级与维护

如果禅道 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，部分接口还在加速完善中，敬请期待后续更新。