agentCLAWHUBUnverified
Zentao API Skills（禅道 API 技能）
调用禅道（ZenTao）RESTful API v2.0 完成用户请求。 推荐使用更好的 ZenTAO CLI 技能（https://clawhub.ai/catouse/zentao-cli） Skill: Zentao API Skills（禅道 API 技能） Owner: catouse Summary: 调用禅道（ZenTao）RESTful API v2.0 完成用户请求。 推荐使用更好的 ZenTAO CLI 技能（https://clawhub.ai/catouse/zentao-cli） Tags: latest:1.0.4 Version history: v1.0.4 | 2026-04-19T10:19:41.379Z | user Version 1.0.4 - 增加元数据 (author, repository, keywords, version) 到 skill 配置，方便分发和归档。 - “常用操作示例”中新增了业务需求（Epic）和用户需求（Requirement）的创建示例，并统一建议创建需求时显式传递 grade 字段。 - “注意事项”补充：创建 Epic / Requireme
OpenClaw
Rank
62
Safety
84
Downloads
1.8k
Updated
Oct 10, 2026
Version
1.0.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.8K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.4release · observed Apr 19, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17ad4nk6htsg75vg6pf20bnhx83kh8a:zentao-api- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-catouse-zentao-api/snapshot"
Documentation
CLAWHUB
86,073 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
--- name: zentao-api description: 调用禅道（ZenTao）RESTful API v2.0 完成用户请求，覆盖项目集、产品、项目、执行、需求（Story/Epic/Requirement）、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、文件等 20 个模块的增删改查及状态流转操作。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、更新需求状态、创建任务等项目管理相关操作时使用本技能。 metadata: author: Sun Hao <[email protected]> repository: https://github.com/easysoft/zentao-skills.git keywords: [zentao, 禅道, api, project-management] version: 1.0.4 --- # 禅道 API v2.0 ## 配置 优先级从高到低： | 变量 | 说明 | |------|------| | `ZENTAO_URL` | 服务器地址，如 `http://zentao.example.com` | | `ZENTAO_TOKEN` | 直接指定 token，跳过登录和缓存（最高优先级），仍需提供服务器地址 | | `ZENTAO_ACCOUNT` | 登录账号，有 token 时可选，但提供可更好回答与当前用户相关的问题 | | `ZENTAO_PASSWORD` | 登录密码，有 token 时无需提供 | **首次登录后 `ZENTAO_URL`、`ZENTAO_TOKEN`、`ZENTAO_ACCOUNT` 写入 `~/.zentao-token.json`，后续无需重复设置**。 若必要变量缺失，提示用户并给出 `export` 命令。用户直接提供服务器、账号和密码时直接使用，同时告知尽量设为环境变量。 ## 认证流程 所有业务 API 需在 Header 携带 `token`。运行 `scripts/get-token.sh` 自动获取： ```bash eval "$(bash scripts/get-token.sh)" # 执行后可直接使用 $ZENTAO_URL、$ZENTAO_TOKEN、$ZENTAO_ACCOUNT ``` 脚本依赖：`curl`、`node` 后续所有请求 Header 携带：`token: $ZENTAO_TOKEN` ## 执行 API 调用的步骤 1. 运行 `eval "$(bash scripts/get-token.sh)"` 获取凭证（自动处理缓存；仍缺失时提示用户） 2. 根据用户意图选择正确的 API 端点（参见 [api-reference.md](api-reference.md)） 3. 若为 PUT 编辑操作且用户未提供全部必填字段，先调用对应 GET 详情接口取回当前数据，再将用户指定的字段覆盖进去 4. 构造请求（方法、URL、Header、Body）并向用户确认写操作内容 5. 执行请求，解析响应 6. 以清晰易读的格式向用户展示结果 ## 模块总览 API 基础路径：`$ZENTAO_URL/api.php/v2` | 模块 | 资源路径 | 支持操作 | |------|---------|---------| | 项目集 Program | `/programs` | CRUD + 关联产品/项目列表 | | 产品 Product | `/products` | CRUD + 关联需求/Bug/用例/计划/发布/反馈/工单/测试单/应用 | | 项目 Project | `/projects` | CUD + 关联执行/需求/Bug/用例/版本/测试单 | | 执行 Execution | `/executions` | CRUD + 关联需求/任务/Bug/用例/版本/测试单 | | 需求 Story | `/stories` | CRUD + change/close/activate | | 业务需求 Epic | `/epics` | CRUD + change/close/activate | | 用户需求 Requirement | `/requirements` | CRUD + change/close/activate | | Bug | `/bugs` | CRUD + resolve/close/activate | | 任务 Task | `/tasks` | CRUD + start/finish/close/activate | | 测试用例 Testcase | `/testcases` | CRUD | | 产品计划 Productplan | `/productplans` | CUD + 按产品查列表 | | 版本 Build | `/builds` | CUD + 按项目/执行查列表 | | 发布 Release | `/releases` | CUD + 按产品查列表 | | 测试单 Testtask | `/testtasks` | CUD + 按产品/项目/执行查列表 | | 反馈 Feedback | `/feedbacks` | CRUD + close/activate | | 工单 Ticket | `/tickets` | CRUD + close/activate | | 应用 System | `/systems` | CU + 按产品查列表 | | 用户 User | `/users` | CRUD | | 文件 File | `/files` | 编辑名称 + 删除 | > CRUD = 创建(POST) + 读取(GET) + 更新(PUT) + 删除(DELETE)；CUD = 无独立全局列表接口 ## 分页与筛选 所有列表接口支持统一的查询参数： | 参数 | 说明 | |------|------| | `browseType` 或 `status` | 筛选状态，如 `all`, `doing`, `unclosed`, `undone` 等（不同模块参数名和可选值不同，详见 [api-reference.md](api-reference.md)） | | `orderBy` | 排序，格式 `字段_asc` 或 `字段_desc`，如 `id_desc`, `title_asc` | | `recPerPage` | 每页数量，最大 1000 | | `pageID` | 页码，从 1 开始 | **筛选参数名不一致**：Program 列表、Execution 全局列表、Task 列表用 `status`，其余用 `browseType`。 ## 常用操作示例 ### 获取进行中的项目及其执行 ```bash curl -s "$ZENTAO_URL/api.php/v2/projects?browseType=doing&recPerPage=1
_meta.json
{
"ownerId": "kn79cz87b6vfpvp7n15tbhqm0n832717",
"slug": "zentao-api",
"version": "1.0.4",
"publishedAt": 1776593981379
}api-reference.md
# 禅道 API v2.0 端点参考
基础路径：`{ZENTAO_URL}/api.php/v2`
认证方式：所有接口（除登录外）需在 Header 携带 `token: <token值>`
写操作需额外携带 `Content-Type: application/json`
**字段标注说明**：**粗体** = 必填，普通 = 可选
---
## 认证（Token）
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/users/login` | 登录获取 token |
请求体：**account**(string), **password**(string)
响应：`{"status":"success","token":"..."}`
---
## 用户（User）
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/users` | 创建用户 |
| GET | `/users` | 获取用户列表 |
| GET | `/users/{userID}` | 获取用户详情 |
| PUT | `/users/{userID}` | 修改用户信息 |
| DELETE | `/users/{userID}` | 删除用户 |
**POST 创建**：**account**(string), **realname**(string), **password**(string)
**PUT 修改**：realname, dept(int), join(date), group(string[]), email, visions(string[] rnd|lite), mobile, weixin, password
**GET 列表参数**：browseType(`inside`|`outside`), orderBy(`id`|`realname`|`account`+`_asc/_desc`), recPerPage, pageID
---
## 项目集（Program）
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/programs` | 创建项目集 |
| GET | `/programs` | 获取项目集列表 |
| GET | `/programs/{programID}` | 获取项目集详情 |
| PUT | `/programs/{programID}` | 修改项目集 |
| DELETE | `/programs/{programID}` | 删除项目集 |
| GET | `/programs/{programID}/products` | 获取项目集的产品列表 |
| GET | `/programs/{programID}/projects` | 获取项目集的项目列表 |
**POST/PUT**：**name**(string), **begin**(date), **end**(date), PM(string), desc(string)
**GET 列表参数**：status(`all`|`unclosed`|`wait`|`doing`|`suspended`|`delayed`|`closed`), orderBy(`id`|`name`|`begin`|`end`+`_asc/_desc`), recPerPage, pageID
---
## 产品（Product）
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/products` | 创建产品 |
| GET | `/products` | 获取产品列表 |
| GET | `/products/{productID}` | 获取产品详情 |
| PUT | `/products/{productID}` | 修改产品 |
| DELETE | `/products/{productID}` | 删除产品 |
**产品关联资源列表：**
| GET 路径 | 说明 |
|---------|------|
| `/products/{id}/stories` | 需求列表 |
| `/products/{id}/epics` | 业务需求列表 |
| `/products/{id}/requirements` | 用户需求列表 |
| `/products/{id}/bugs` | Bug 列表 |
| `/products/{id}/testcases` | 测试用例列表 |
| `/products/{id}/productplans` | 产品计划列表 |
| `/products/{id}/releases` | 发布列表 |
| `/products/{id}/testtasks` | 测试单列表 |
| `/products/{id}/feedbacks` | 反馈列表 |
| `/products/{id}/tickets` | 工单列表 |
| `/products/{id}/systems` | 应用列表 |
**POST/PUT**：**name**(string), program(int), line(int), type(`normal`|`branch`|`platform`), PO(string), reviewer(string[]), desc(string[]), QD(string), RD(string), acl(`open`|`private`)
**GET 列表参数**：browseType(`all`|`noclosed`|`closed`), orderBy(`id`|`title`|`begin`|`end`+`_asc/_desc`), recPerPage, pageID
---
## 项目（Project）
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/projects` | 创建项目 |
| GET | `/projects` | 获取项目列表 |
| PUT | `/projects/{projectID}` | 修改项目 |
| DELETE | `/projects/{projectID}` | 删除项目 |
**项目关联资源列表：**
| GET 路径 | 说明 |
|---------|------|
| `/projects/{id}/executions` | 执行列表 |
| `/projects/{id}/stories` | 需求列表 |
| `/projects/{id}/bugs` | Bug 列表 |
| `/projects/{id}/testcases` | 测试用例列表 |
| `/projects/{id}/builds` | 版本列表 |
| `/projects/{id}/skill-card.md
## Description: 调用禅道（ZenTao）RESTful API v2.0 完成用户请求，覆盖项目集、产品、项目、执行、需求（Story/Epic/Requirement）、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、文件等 20 个模块的增删改查及状态流转操作。 This skill is ready for commercial/non-commercial use. ## Publisher: [catouse](https://clawhub.ai/user/catouse) ### License/Terms of Use: MIT-0 ## Use Case: Developers and project teams use this skill to query and update ZenTao project management records through the ZenTao RESTful API v2.0. It supports common workflows such as listing projects and bugs, creating tasks or requirements, and changing issue or task status. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Credential handling stores ZenTao URL, token, and account data in ~/.zentao-token.json. Mitigation: Treat the token cache as sensitive credential material and restrict access to trusted local environments. Risk: The documented eval-based token-loading flow can execute unexpected shell output if the helper script or environment is compromised. Mitigation: Review the helper script before use, avoid the eval flow unless it is fixed, and prefer safer environment-variable handling. Risk: The skill can create, update, delete, and change status for live ZenTao records. Mitigation: Confirm every write or delete operation unless the user has explicitly authorized direct mutation. Risk: Using an untrusted or non-HTTPS ZenTao server can expose credentials and project data. Mitigation: Use the skill only with trusted ZenTao servers and prefer HTTPS-only URLs. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/catouse/skills/zentao-api) - [Repository metadata](https://github.com/easysoft/zentao-skills.git) - [ZenTao API 2.0 official documentation](https://www.zentao.net/book/api/2309.html) - [ZenTao API 1.0 documentation](https://www.zentao.net/book/api/1397.html) - [Artifact API reference](artifact/api-reference.md) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, API calls, guidance] **Output Format:** [Markdown with inline shell commands and JSON API payloads] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include proposed ZenTao API requests and parsed response summaries; write or delete operations should be confirmed before execution.] ## Skill Version(s): 1.0.4 (source: frontmatter and server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
Github ReposUpdated 8h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/catouse/skills/zentao-api",
"sourceUrl": "https://clawhub.ai/catouse/skills/zentao-api",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T02:34:15.061Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-catouse-zentao-api/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-catouse-zentao-api/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T02:34:15.061Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.8K downloads",
"href": "https://clawhub.ai/catouse/zentao-api",
"sourceUrl": "https://clawhub.ai/catouse/zentao-api",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T02:34:15.061Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.4",
"href": "https://clawhub.ai/catouse/zentao-api",
"sourceUrl": "https://clawhub.ai/catouse/zentao-api",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-19T10:19:41.379Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-catouse-zentao-api/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-catouse-zentao-api/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.4",
"description": "Version 1.0.4 - 增加元数据 (author, repository, keywords, version) 到 skill 配置，方便分发和归档。 - “常用操作示例”中新增了业务需求（Epic）和用户需求（Requirement）的创建示例，并统一建议创建需求时显式传递 grade 字段。 - “注意事项”补充：创建 Epic / Requirement / Story 时应显式传 grade，避免有些禅道环境下需求层级异常（如标签显示不正确）。 - 其余文档内容未改动，功能无变动。",
"href": "https://clawhub.ai/catouse/zentao-api",
"sourceUrl": "https://clawhub.ai/catouse/zentao-api",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-19T10:19:41.379Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.