Metadata-Version: 2.4
Name: zentao-cli
Version: 1.0.0
Summary: 禅道项目管理 CLI - 任务查询、创建、编辑、工时记录、6R报表，可集成 OpenClaw
Project-URL: Homepage, https://github.com/bao-xie/zentao-cli
Project-URL: Issues, https://github.com/bao-xie/zentao-cli/issues
Author: Bao Xie
License: MIT
License-File: LICENSE
Keywords: chandao,openclaw,project-management,task-management,zentao
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Bug Tracking
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Description-Content-Type: text/markdown

# zentao-cli

禅道项目管理 CLI 工具，支持任务查询、创建、编辑、工时记录和 6R 报表生成。

可独立使用，也可作为 [OpenClaw](https://docs.openclaw.ai) Skill 集成到 AI agent 中。

## 安装

```bash
pip install zentao-cli
```

或通过 `pipx` / `uvx` 一次性运行：

```bash
uvx zentao-cli list --status done
```

## 配置

通过环境变量配置（必填）：

```bash
export ZENTAO_HOST="https://zentao.example.com"
export ZENTAO_ACCOUNT="your_account"
export ZENTAO_PASSWORD="your_password"
export ZENTAO_DEFAULT_EXECUTION_NAME="运维"   # 默认执行名称
```

可选：

```bash
export ZENTAO_DEFAULT_ASSIGNEE=""       # 默认指派人，留空则同 ACCOUNT
export ZENTAO_DEFAULT_TASK_TYPE="devel" # 默认任务类型
```

## 使用

```bash
# 查询任务
zentao list
zentao list --status done
zentao list --start-date 2026-03-01 --end-date 2026-03-31
zentao list --json

# 任务详情
zentao get 123

# 创建任务（自动完成）
zentao create \
  --title "修复 Nginx 配置" \
  --description "生产环境配置错误" \
  --work-content "排查并修复 upstream 配置" \
  --acceptance-criteria "服务正常转发"

# 编辑任务
zentao edit 123 --status done
zentao edit 123 --title "新标题" --assigned-to someone

# 删除任务
zentao delete 123

# 记录工时
zentao effort 123 --hours 2 --work "排查并修复配置"

# 生成 6R 报表
zentao report --start-date 2026-03-01 --end-date 2026-03-15
```

## OpenClaw 集成

安装 CLI 后，将 `SKILL.md` 复制到 OpenClaw skills 目录即可：

```bash
pip install zentao-cli
mkdir -p ~/.openclaw/skills/zentao-task-manager
cp SKILL.md ~/.openclaw/skills/zentao-task-manager/
```

在 `~/.openclaw/openclaw.json` 中配置环境变量：

```json
{
  "skills": {
    "entries": {
      "zentao-task-manager": {
        "enabled": true,
        "env": {
          "ZENTAO_HOST": "https://zentao.example.com",
          "ZENTAO_ACCOUNT": "your_account",
          "ZENTAO_PASSWORD": "your_password",
          "ZENTAO_DEFAULT_EXECUTION_NAME": "运维"
        }
      }
    }
  }
}
```

重启 gateway 即可使用。

## License

MIT
