技能 zentao-api
📦

zentao-api

安全

使用 AI 管理 ZenTao 项目

将 Claude 与 ZenTao 项目管理系统集成,通过 REST API v2.0 自动化项目跟踪、缺陷管理和任务工作流程操作。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“zentao-api”。 Show me the top 5 bugs by severity in product 123

预期结果:

以下是产品 123 中前 5 个高严重程度缺陷:

1. [P1] 数据库连接池耗尽 - 打开日期:2026-04-25 - 分配给:developer@example.com
2. [P1] 移动端登录页面崩溃 - 打开日期:2026-04-24 - 分配给:mobile-team@example.com
3. [P2] 文件上传超时 - 打开日期:2026-04-23 - 分配给:backend@example.com
4. [P2] 仪表板小部件未加载 - 打开日期:2026-04-22 - 分配给:frontend@example.com
5. [P2] 导出功能损坏 - 打开日期:2026-04-21 - 分配给:data-team@example.com

正在使用“zentao-api”。 Create a task in sprint 5 named 'Implement search feature' assigned to Alice with 8 hours estimate

预期结果:

已在 Sprint 5 中成功创建任务:

任务 ID:12345
名称:Implement search feature
分配给:Alice
估算时间:8 小时
执行:Sprint 5
状态:Open

安全审计

安全
v1 • 4/27/2026

All 628 static analysis findings are false positives. The skill is a legitimate ZenTao API integration tool for project management operations. Detected patterns (backtick syntax, weak crypto flags, high entropy) are misclassifications of markdown documentation and API parameter values. No malicious behavior confirmed after human review.

3
已扫描文件
776
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

45
架构
100
可维护性
87
内容
50
社区
100
安全
83
规范符合性

你能构建什么

项目经理查询冲刺进度

项目经理可以查询活跃冲刺、待处理缺陷和任务完成率,无需手动访问 Web 界面即可了解其 ZenTao 项目的状态。

开发者创建和解决缺陷

开发者可以通过自然语言请求记录新缺陷、更新缺陷状态、使用解决方案代码解决问题,并将缺陷关联到特定构建。

QA 创建测试用例和管理测试套件

QA 工程师可以通过对话命令创建测试用例、将其关联到产品、管理测试任务和跟踪测试执行结果。

试试这些提示

获取项目状态
显示 ZenTao 中所有活跃项目及其当前进度,包括未关闭的缺陷和待处理任务。
创建并分配缺陷
在产品 {productID} 中创建一个新缺陷,标题为「{bug title}」,分配给 {developer},严重程度为 {severity},并将其标记为针对主干构建。
管理任务工作流程
启动分配给我的任务 {taskID},完成后将其标记为已完成,并记录 4 小时的工作时间。
批量状态更新
获取项目 {projectID} 中状态为「active」的所有缺陷,然后关闭昨天标记为已解决的那些缺陷。

最佳实践

  • 将 ZenTao 凭据配置为环境变量(ZENTAO_URL、ZENTAO_TOKEN)以实现安全复用
  • 编辑现有记录时,始终先 GET 当前数据,然后使用合并后的更改进行 PUT
  • 创建 Epic/Story/Requirement 时使用明确的 grade 参数以避免显示问题

避免

  • 不要假设 browseType 适用于所有模块 - Program 和 Task 使用「status」
  • 除非明确请求,否则不要跳过写操作的用户确认
  • 不要无限期缓存令牌而不检查 API 调用时的 401 错误

常见问题

我需要配置哪些凭据?
你需要 ZENTAO_URL(服务器地址)和直接使用 ZENTAO_TOKEN,或使用 ZENTAO_ACCOUNT 加 ZENTAO_PASSWORD 进行登录。
令牌缓存如何工作?
首次登录后,凭据会保存到 ~/.zentao-token.json。后续调用使用缓存的令牌而无需重新身份验证。
如果我的令牌过期了怎么办?
如果收到 401 错误,请删除 ~/.zentao-token.json 并重新运行身份验证以获取新令牌。
我可以创建关联到多个构建的缺陷吗?
可以,openedBuild 字段接受构建 ID 数组,如 ["trunk", "v2.1.0"]。
Epic、Story 和 Requirement 有什么区别?
这三者都是需求类型,具有不同的层级结构。Epic(BR)是最高级别,Story(SR)是标准级别,Requirement 用于用户级需求。
如何带原因关闭需求?
使用 PUT /stories/{id}/close 或 /requirements/{id}/close 并带 closedReason 参数。有效值包括 done、subdivided、duplicate、postponed、willnotdo、cancel、bydesign。

开发者详情

文件结构