zentao-cli 1.0.0__tar.gz

zentao_cli-1.0.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+
+# IDE
+.vscode/
+.idea/
+
+# 备份和临时文件
+archive/
+*.tar.gz
+*.bak
+*.tmp
+*.swp
+
+# 日志
+logs/
+
+# 敏感信息（按需取消注释）
+# configs/certs/
+# ansible/group_vars/pve_hosts.yml
+
+# Kiro specs（可选保留）
+# .kiro/specs/
+
+# OS
+.DS_Store
+Thumbs.db

zentao_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-zentao contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zentao_cli-1.0.0/PKG-INFO

@@ -0,0 +1,128 @@
+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

zentao_cli-1.0.0/README.md

@@ -0,0 +1,104 @@
+# 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

zentao_cli-1.0.0/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: zentao-task-manager
+description: 禅道项目管理 - 通过 zentao CLI 创建任务、记录工时、查询任务、生成6R报表
+version: 2.0.0
+metadata:
+  {"openclaw": {"requires": {"bins": ["zentao"]}, "primaryEnv": "ZENTAO_HOST", "emoji": "📋"}}
+---
+
+# 禅道任务管理 Skill
+
+通过 `zentao` CLI 连接禅道项目管理系统，支持任务全生命周期管理和工时记录。
+
+## CLI 用法
+
+所有操作通过 `zentao` 命令完成。环境变量已预配置，直接调用即可。
+
+### 查询任务
+
+```bash
+# 查询所有任务
+zentao list
+
+# 按状态筛选
+zentao list --status done
+zentao list --status doing
+
+# 按日期范围
+zentao list --start-date 2026-03-01 --end-date 2026-03-31
+
+# JSON 输出（适合程序处理）
+zentao list --json
+```
+
+### 获取任务详情
+
+```bash
+zentao get 123
+zentao get 123 --json
+```
+
+### 创建任务
+
+将用户口语化描述整理为结构化格式后调用：
+
+```bash
+zentao create \
+  --title "修复 Nginx 反向代理配置异常" \
+  --description "生产环境 Nginx 配置错误导致请求转发失败" \
+  --work-content "排查配置文件，修复 upstream 指向，重载并验证" \
+  --acceptance-criteria "配置语法检查通过，服务请求转发正常"
+```
+
+可选参数：
+- `--est-hours 2` — 预计工时
+- `--start-date 2026-03-23` — 开始日期（默认今天）
+- `--end-date 2026-03-23` — 结束日期（默认今天）
+- `--assigned-to someone` — 指派给谁（默认当前用户）
+- `--completion-note "已验证通过"` — 完成说明
+- `--no-auto-finish` — 不自动完成（默认会自动完成任务）
+
+### 编辑任务
+
+```bash
+# 修改标题
+zentao edit 123 --title "新标题"
+
+# 完成任务
+zentao edit 123 --status done
+
+# 修改多个字段
+zentao edit 123 --assigned-to someone --end-date 2026-03-25
+```
+
+### 删除任务
+
+```bash
+zentao delete 123
+```
+
+### 记录工时
+
+```bash
+zentao effort 123 --hours 2 --work "排查并修复配置问题"
+zentao effort 123 --hours 1.5 --work "代码审查" --date 2026-03-22
+```
+
+### 生成 6R 报表
+
+```bash
+zentao report --start-date 2026-03-01 --end-date 2026-03-15
+zentao report --start-date 2026-03-01 --end-date 2026-03-15 --department "信息中心"
+```
+
+## 创建任务的整理原则
+
+当用户要求创建禅道任务时，将口语化描述整理为结构化格式：
+
+1. 语言专业、克制、偏事实描述，不使用口语
+2. 明确区分：任务标题 / 任务描述 / 工作内容 / 验收标准 / 完成说明
+3. 描述聚焦"做了什么 + 交付了什么"，避免空话
+4. 不主动扩大范围，不替用户承诺时间或结果
+5. 默认场景为企业运维/研发协作环境
+6. 不指定日期默认使用今天
+
+示例：用户说"帮我记一下今天修了 nginx 配置"，整理为：
+- 标题：修复 Nginx 反向代理配置异常
+- 描述：生产环境 Nginx 配置错误导致请求转发失败
+- 工作内容：排查配置文件，修复 upstream 指向，重载并验证
+- 验收标准：配置语法检查通过，服务请求转发正常

zentao_cli-1.0.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "zentao-cli"
+version = "1.0.0"
+description = "禅道项目管理 CLI - 任务查询、创建、编辑、工时记录、6R报表，可集成 OpenClaw"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Bao Xie"}
+]
+keywords = ["zentao", "chandao", "project-management", "task-management", "openclaw"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Bug Tracking",
+]
+dependencies = [
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/bao-xie/zentao-cli"
+Issues = "https://github.com/bao-xie/zentao-cli/issues"
+
+[project.scripts]
+zentao = "zentao_cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["zentao_cli"]