# Manage ZenTao projects with AI

Integrate Claude with ZenTao project management system to automate project tracking, bug management, and task workflow operations through REST API v2.0.

## Install

```bash
npx skillstore add easysoft/zentao-api
```

## Metadata

- - Slug: easysoft-zentao-api
- - Version: 1.0.0
- - Author: easysoft
- - GitHub username: easysoft
- - License: MIT
- - Repository: https://github.com/easysoft/zentao-skills/tree/main/skills/zentao-api
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: safe
- - Quality score: 77
- - Quality tier: bronze
- - Public page: https://skillstore.pages.dev/skills/easysoft-zentao-api
- - Manifest: https://skillstore.pages.dev/api/skills/easysoft-zentao-api/manifest

## Capabilities

- Query and manage projects, products, programs, and executions via ZenTao REST API v2.0
- Create, update, resolve, and close bugs with automatic build reference handling
- Manage requirements, epics, stories, and user requirements with state transitions
- Create, start, finish, and close tasks with time tracking support
- Query and manage test cases, test tasks, releases, and feedback items
- Handle user authentication with secure token caching to local configuration file

## Use Cases

- Project Manager queries sprint progress: Project managers can ask about active sprints, pending bugs, and task completion rates across their ZenTao projects without manually accessing the web interface.
- Developer creates and resolves bugs: Developers can log new bugs, update bug status, resolve issues with resolution codes, and link bugs to specific builds directly through natural language requests.
- QA creates test cases and manages test suites: QA engineers can create test cases, link them to products, manage test tasks, and track test execution results through conversational commands.

## Prompt Templates

### Get project status

```
Show me all active projects in ZenTao and their current progress including open bugs and pending tasks.
```

### Create and assign bug

```
Create a new bug in ZenTao for product {productID} with title "{bug title}" assigned to {developer}, severity {severity}, and mark it against the trunk build.
```

### Manage task workflow

```
Start task {taskID} that was assigned to me, and when finished, mark it as completed with 4 hours of work logged.
```

### Bulk status update

```
Get all bugs with status 'active' in project {projectID}, then close the ones that were marked as resolved yesterday.
```

## Limitations

- Requires valid ZenTao server credentials or pre-configured access token
- Cannot create execution without existing project context
- Some API parameter names vary between modules \(e.g., browseType vs status\)

## Best Practices

- Configure ZenTao credentials as environment variables \(ZENTAO\_URL, ZENTAO\_TOKEN\) for secure re-use
- When editing existing records, always GET current data first then PUT with merged changes
- Use explicit grade parameter when creating Epic/Story/Requirement to avoid display issues

## Anti Patterns

- Do not assume browseType works for all modules - Program and Task use 'status' instead
- Do not skip user confirmation for write operations unless explicitly requested
- Do not cache tokens indefinitely without checking for 401 errors on API calls

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-04-27T06:17:36.117\+00:00
- - Summary: 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.

## Stats

- - Views: 89
- - Downloads: 2
- - Favorites: 1
- - Popularity score: 0