at-zentao

Manage ZenTao bugs and tasks end to end through a secure CLI with confirmation-gated writes.

180|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/kairyou/agent-tools --skill at-zentao-kairyou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: at-zentao
Source: https://github.com/kairyou/agent-tools/tree/main/skills/systems/at-zentao
Command: npx skills add https://github.com/kairyou/agent-tools --skill at-zentao-kairyou

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Working ZenTao (禅道) bugs and tasks normally requires switching between the issue tracker, the codebase, and Git while manually updating statuses, hours, and resolution comments. This Skill connects those steps so an agent can fetch an item, fix the code, commit, and write back to ZenTao without exposing credentials or skipping confirmations. ## Core Features & Use Cases - End-to-end bug and task workflow: Fetch a bug or task with its comments and attachments, fix the code, verify, stage, commit with a bug#<id> or task#<id> token, and write back a resolution or completion comment only after explicit confirmation. - Task lifecycle and time tracking: Start, pause, resume, and finish tasks, log or correct work hours through ZenTao's native effort workflow, with all writes shown and confirmed first. - Read-only queries and export: List bugs, tasks, and stories by person, relation, and status; read linked story scope and acceptance criteria; export a self-contained Markdown handoff bundle with downloaded images. - Use Case: A developer runs /at-zentao bug 30887, reviews the bug and its screenshots, fixes the session renewal logic, commits as fix(auth): bug#30887 reject expired sessions, and confirms a write-back comment with root cause, fix, and commit hash. ## Quick Start Ask the agent to handle a ZenTao item, for example: work on ZenTao bug 30887 and update it after the fix is committed.

Frequently Asked Questions about at-zentao

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I work a ZenTao bug from my coding agent?▼

Run the skill with the bug id, such as /at-zentao bug 30887. The agent fetches the bug with its comments and attachments, fixes the code, verifies the change, commits with a bug#<id> token, and asks before writing the resolution back to ZenTao.

How do I log or correct work hours on a ZenTao task?▼

Use a natural request like /at-zentao task 123 log hours. The CLI records consumed and remaining hours through ZenTao's native effort workflow, and corrections use edit-hours on a specific effort record after showing current and proposed values for confirmation.

Where are ZenTao credentials stored and are they safe?▼

Credentials live in ~/.agent-tools/config.jsonc or environment variables such as ZENTAO_PASSWORD and ZENTAO_TOKEN. Only the bundled CLI reads them, output is sanitized, and the agent never prints passwords, tokens, or authorization headers.

Can I query another person's ZenTao bugs or tasks?▼

Yes, read-only list queries accept a person name or account with relations like assignedTo, finishedBy, or resolvedBy and optional status filters. Authentication still uses the configured account, and ambiguous names require an exact account.

Does the skill commit or update ZenTao automatically?▼

No. Every commit and every ZenTao write requires separate explicit confirmation. The agent shows the commit message or the exact resolution, comment, or hours payload first, and never invokes write commands before approval.