社区

禅道技能库

禅道官方技能库 https://github.com/easysoft/zentao-skills

2 技能 0 安装次数

3 天前更新

安装

运行此命令，安装该技能包中的全部技能：

npx skillstore add @zentao-skills

CLI 会自动检测 Codex 和 Claude Code 文件夹；如果两者都可用，就会同时安装。

概览

使用指南

由 AI 增强

快速开始

1
安装并配置插件

将 zentao-skills 插件添加到你的 AI assistant，并提供你的 ZenTao server URL 和 API token。
```
Plugin loaded. Set environment: ZENTAO_URL=https://your-zentao.com/api.php?m=api&f=admin ZENTAO_TOKEN=your_token
```
2
使用 zentao-cli 查询第一条数据

使用 CLI 列出所有 active projects。
```
zentao-cli list projects --status active
```

创建一个简单 Task

在现有 project 中创建一个新 task。

zentao-cli create task --title "Setup demo environment" --project 5 --assignee "John"

4
开始交互式导览

请求基于角色的导览，使用 zentao-tour 探索 ZenTao 功能。
```
"Start a ZenTao tour as a Developer"
```
5
更新 Bug 状态

将 bug 流转为 'Resolved'。
```
zentao-cli transition bug 123 to resolved
```

详细指南

# zentao-skills 使用指南

## 概述
ZenTao 出品的 **zentao-skills** 插件提供两个强大的技能，用于与 ZenTao 项目管理系统交互：
- **zentao-cli**：用于查询和操作 ZenTao 数据（例如 projects、stories、bugs、tasks）的命令行界面。
- **zentao-tour**：一个基于聊天的交互式导览，会根据用户角色引导用户了解 ZenTao 和 CLI。

此插件非常适合希望简化工作流或学习系统的项目经理、开发人员、QA 和管理人员。

## 安装
1. 确保你可以访问 ZenTao 实例。
2. 在你的 AI assistant（例如 ChatGPT）或开发环境中安装该插件。
3. 如有需要，配置身份验证（API token 或 credentials）。

## zentao-cli 用法

### 基础查询
- `zentao-cli list projects` – 显示所有 projects。
- `zentao-cli get bug 123` – 获取 bug #123 的详细信息。
- `zentao-cli create task --title "Fix login issue" --priority high` – 创建一个新 task。

### 状态流转
- `zentao-cli transition story 456 to resolved` – 更改 story 状态。
- `zentao-cli assign task 789 to user "john"` – 分配一个 task。

### 示例工作流
**查询 project 进度：**
```
zentao-cli list projects --status active
zentao-cli get project 10 --show-tasks
```

**更新一个 bug：**
```
zentao-cli update bug 42 --severity critical --comment "Fixed in latest build"
```

## zentao-tour 用法

### 开始导览
只需说："Start a ZenTao tour as a Project Manager" 或 "Show me how to use zentao-cli for QA."

导览将会：
1. 识别你的角色。
2. 逐步介绍相关实体（stories、tasks、bugs）。
3. 在沙盒化的 ZenTao 环境中执行示例 CLI commands。

### 导览期间的关键命令
- `next` – 进入下一步。
- `pause` – 暂停导览。
- `repeat` – 重复当前说明。
- `exit` – 结束导览。

## 提示
- 在命令后使用 `--help` 查看可用选项。
- 对于批量操作，可以考虑编写脚本执行多个命令。
- 导览是自助式的，并会在完成后重置。

## 故障排查
- **Authentication errors**：验证你的 API token。
- **Command not found**：确保插件已加载。
- **Data not found**：检查 project ID 或权限。

更多详情，请访问 [GitHub repository](https://github.com/easysoft/zentao-skills)。