# zendao-skill

**Repository Path**: numen06/zendao-skill

## Basic Information

- **Project Name**: zendao-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 禅道全能 Skill

> **版本**: 2.1.0  
> **类型**: AI 技能包 / 多工具整合  
> **适用**: 禅道开源版 18.x / API V1 & V2  
> **整合**: JAJA DevOps 实战版 + [easysoft/zentao-skills](https://github.com/easysoft/zentao-skills.git) 官方版

---

## 什么是这个 Skill？

一个经过真实环境验证的禅道（ZenTao）全能 AI 技能包，支持四种交互方式：

| 工具 | 适用场景 |
|------|----------|
| **zentao-cli** | 日常快速查询/操作，自动处理编码问题 |
| **PowerShell 脚本库** | Windows 自动化，复用现成脚本 |
| **Python SDK** | 复杂业务逻辑、批量操作 |
| **REST API v2** | 精准 API 调用、调试 |

安装后，AI 可以帮你：
- ✅ 查询/创建/修改/删除产品、项目、需求、Bug、任务
- ✅ 管理执行（Sprint/迭代）、测试用例、测试单
- ✅ 管理团队权限（产品负责人/项目经理/白名单）
- ✅ 处理反馈、工单、产品计划、版本发布
- ✅ 批量操作禅道数据

---

## 快速安装

```bash
git clone https://gitee.com/numen06/zendao-skill.git
```

安装依赖：
```bash
pip install requests
npm install -g zentao-cli
```

将整个目录复制到你的 AI 工具的 skill 目录即可。

---

## 一键配置

```powershell
# 同时初始化 zentao-cli、API Token、Python SDK 三套认证
powershell -File scripts/init-config.ps1
```

---

## 使用方式

### zentao-cli（推荐）

```bash
# 查看任务
zentao task --execution=154 --pick=id,name,status

# 创建任务
zentao task create --execution=154 --name="新任务" --assignedTo=admin

# 完成任务
zentao task finish 1436 --consumed=8

# 查看 Bug
zentao bug --product=1 --filter='status:active'
```

### PowerShell 脚本

```powershell
# 查询任务
& scripts/dispatcher.ps1 -Action query-tasks -Params @{ ExecutionId = 154 }

# 创建任务
& scripts/dispatcher.ps1 -Action create-task -Params @{
    ExecutionId = 154; Name = "新任务"; AssignedTo = "admin"; Deadline = "2026-04-30"
}
```

### Python SDK

```python
from zentao_sdk import ZentaoClient

with ZentaoClient("https://你的禅道地址", "账号", "密码") as z:
    # 产品管理
    pid = z.products.create("新产品", code="PROD_001")
    z.teams.assign_product_team(pid, po="pm_user", rd="dev_user", qd="qa_user",
                                 whitelist=["admin"], acl="private")
    # 任务管理
    tasks = z.issues.list_tasks(execution_id=154)
    z.issues.create_task(154, "新任务", assigned_to="admin", type="devel")
```

---

## 示例对话

```
你: 帮我查一下执行154的所有进行中任务

AI: （使用 zentao-cli）
    | #1436 | 容器管理-后端 | 🔵 进行中 | 2026-04-24 |
    | #1437 | 容器类型-后端 | 🔵 进行中 | 2026-04-21 |

你: 把1436完成，消耗8小时

AI: 即将执行：完成任务 #1436，消耗 8 小时。确认？

你: 确认

AI: ✅ 任务 #1436 已完成！
```

---

## 文件结构

```
zentao-sdk/
├── SKILL.md              # AI 技能指南（完整）
├── README.md             # 本文件
├── zentao_sdk/           # Python SDK 包
├── tests/                # 闭环测试
├── scripts/              # PowerShell 脚本库
│   ├── init-config.ps1   # 一键配置
│   ├── dispatcher.ps1    # 统一调度器
│   └── ...               # 各类操作脚本
├── skills/               # 独立技能包
│   └── team-weekly-report/  # 团队周报生成 Skill
└── references/           # 参考资料
    ├── api-reference.md  # 完整 API v2 参考
    ├── output-standards.md
    └── common-issues.md  # 踩坑经验
```

---

## 技术信息

- **SDK 版本**: 2.0.0
- **支持模块**: 19 个模块（产品/项目/执行/需求/Bug/任务/测试用例/测试单/计划/版本/发布/反馈/工单等）
- **API 版本**: V1 & V2
- **Python 版本**: >= 3.7
- **Node.js 版本**: >= 14（zentao-cli）
- **PowerShell**: >= 5.1
- **依赖**: requests >= 2.25.0

---

## 版本历史

### v2.0.0 (2026-04-20)
- **整合升级**：合并 easysoft 官方 zentao-skills（zentao-api + zentao-cli + zentao-sdk-skill）

### v2.1.0 (2026-04-27)
- 新增 `reports` 模块：任务批量跨执行查询、完成日期过滤、延期标记、执行信息获取
- 新增 `skills/team-weekly-report/`：独立团队周报生成 Skill，支持命令行生成和推送到禅道
- 新增 zentao-cli 完整命令参考（19 个模块）
- 新增 REST API v2 完整模块总览
- 新增 `references/api-reference.md`
- 升级踩坑指南
- 工具选择优先级：zentao-cli > PowerShell > API > SDK

### v1.3.0 (2026-04-17)
- 完善文档和安装说明
- 增加团队权限最佳实践

### v1.2.0
- 新增产品指派（PO/RD/QD/白名单）
- 新增项目团队（PM/白名单/访问控制）

### v1.0.0
- 初始版本，覆盖 13 个核心模块