zentaoスキル

# Usage Guide for zentao-skills

## Overview
The **zentao-skills** plugin by ZenTao provides two powerful skills for interacting with the ZenTao project management system:
- **zentao-cli**: A command-line interface to query and manipulate ZenTao data (e.g., projects, stories, bugs, tasks).
- **zentao-tour**: An interactive chat-based tour that guides users through ZenTao and the CLI based on their role.

This plugin is ideal for project managers, developers, QA, and executives who want to streamline their workflow or learn the system.

## Installation
1. Ensure you have access to a ZenTao instance.
2. Install the plugin in your AI assistant (e.g., ChatGPT) or development environment.
3. Configure authentication (API token or credentials) if required.

## zentao-cli Usage

### Basic Queries
- `zentao-cli list projects` – Show all projects.
- `zentao-cli get bug 123` – Get details of bug #123.
- `zentao-cli create task --title "Fix login issue" --priority high` – Create a new task.

### Status Transitions
- `zentao-cli transition story 456 to resolved` – Change story status.
- `zentao-cli assign task 789 to user "john"` – Assign a task.

### Example Workflows
**Query project progress:**
```
zentao-cli list projects --status active
zentao-cli get project 10 --show-tasks
```

**Update a bug:**
```
zentao-cli update bug 42 --severity critical --comment "Fixed in latest build"
```

## zentao-tour Usage

### Start a Tour
Simply say: "Start a ZenTao tour as a Project Manager" or "Show me how to use zentao-cli for QA."

The tour will:
1. Identify your role.
2. Walk through relevant entities (stories, tasks, bugs).
3. Execute sample CLI commands in a sandboxed ZenTao environment.

### Key Commands During Tour
- `next` – Proceed to next step.
- `pause` – Pause the tour.
- `repeat` – Repeat the current instruction.
- `exit` – End the tour.

## Tips
- Use `--help` after a command to see available options.
- For bulk operations, consider scripting multiple commands.
- The tour is self-guided and resets after completion.

## Troubleshooting
- **Authentication errors**: Verify your API token.
- **Command not found**: Ensure the plugin is loaded.
- **Data not found**: Check project ID or permissions.

For more details, visit [the GitHub repository](https://github.com/easysoft/zentao-skills).