Zentao Task Planner

---
name: zentao-task-planner
description: Plan Zentao tasks, and perform Zentao operations including creating tasks, logging work hours, and completing tasks.规划禅道任务，以及对禅道操作，创建任务、录入工时、完成任务。
---

## Overview

You need to plan, clarify, standardize, and confirm tasks so that users can input all relevant information at once. Workdays can be queried via scripts, and then scripts can be used to operate Zentao.

## 脚本
### 普通脚本
- `get_next_workdays.py` 用于查询当前或下一段连续工作日，在规划阶段使用，一般情况下是规划本周或者下周工作日的任务。

### 禅道脚本
- `get_task_types.py` 从禅道页面获取任务类型枚举
- `list_tasks.py` 查看用户当前任务列表
- `create_tasks.py` 创建任务，只能在任务表确认后使用
- `finish_tasks_by_date.py` 按日期范围批量完成任务
- `repair_task_finish_date.py` 修复任务填错的完成日期
- `close_finished_tasks.py` 关闭已完成但未关闭的任务

### 脚本执行规则

1. 未经用户明确确认，不要执行有副作用的禅道操作。
2. 脚本用法、参数、命令示例统一以 [references/commands.md](references/commands.md) 及其分脚本文档为准。
3. 不要为了了解脚本怎么用而直接通读源码。

## 安全与隐私

- 凭据（`ZENTAO_ACCOUNT` / `ZENTAO_PASSWORD`）只从进程环境变量或用户本地的 `.env` 文件读取，本技能不包含、不生成、不转发任何凭据。
- 所有网络请求统一经过地址校验，只会发往用户自己配置的 `ZENTAO_BASE_URL`，不访问任何第三方服务，无遥测。
- 登录凭据通过 POST 表单体提交，不会出现在 URL 或日志中；错误输出不包含凭据。
- 所有写操作默认预览（dry-run），必须显式加 `--execute` 并经用户确认后才会写入禅道。
- 详细说明见 [SECURITY.md](SECURITY.md)。

## 资源

- [references/plan-task.md](references/plan-task.md)：规划任务规则说明
- [references/commands.md](references/commands.md)：命令索引、环境要求、公共执行规则
- [references/workdays.md](references/workdays.md)：查询连续工作日
- [references/list-tasks.md](references/list-tasks.md)：查看任务列表
- [references/get-task-types.md](references/get-task-types.md)：获取任务类型枚举
- [references/create-tasks.md](references/create-tasks.md)：批量创建任务
- [references/finish-tasks.md](references/finish-tasks.md)：按日期完成任务
- [references/repair-finish-date.md](references/repair-finish-date.md)：修复任务完成日期
- [references/close-tasks.md](references/close-tasks.md)：关闭已完成任务
- `scripts/zentao_common.py`：本技能内部实现逻辑，通常无需直接阅读