zentao-ai-agent
自动化规划与执行禅道任务，提升项目管理效率。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：zentao-ai-agent。 它的用途是：自动化规划与执行禅道任务，提升项目管理效率。 完整的 Skill 内容见：https://321skill.com/skills/zentao-ai-agent/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我规划下周的工作任务，并批量创建到禅道。”，它会引导你准备标准格式的TSV任务表，然后调用 `create_tasks.py` 脚本，在预览确认后，一键将多个任务创建到指定的禅道项目中。或者，
对AI说：“把我上周已完成的所有禅道任务都关闭。”，它会调用 `close_finished_tasks.py` 脚本，自动筛选并关闭状态为“已完成”但未关闭的任务。
介绍
Zentao AI Agent 是一个旨在解决禅道项目管理中重复性操作繁琐、批量任务处理效率低下问题的脚本工具集。它通过提供一系列Python脚本，帮助用户自动化执行任务规划、查看、批量创建、按日期完成及关闭等常见操作，将用户从手动点击和填写的重复劳动中解放出来。
使用方式非常直接，用户只需配置好禅道系统的连接信息，即可通过命令行调用不同的脚本，实现对应功能。例如，通过 list_tasks.py 快速查看个人待办，或通过 create_tasks.py 配合标准化的TSV任务表，一键批量创建多个任务。所有具有副作用的操作（如创建、完成、关闭）都支持预览模式，确认无误后再执行，确保安全。
该工具非常适合需要频繁使用禅道进行任务管理的研发团队成员，特别是项目经理、开发人员和测试工程师。他们常常需要处理大量任务的状态更新、进度跟踪和批量创建工作。
在使用时，建议先在测试环境或使用预览模式（不加 --execute 参数）熟悉操作流程。同时，确保任务表（TSV格式）的列分隔符和日期格式正确，并提前配置好人员姓名到禅道账号的映射关系，以保证批量创建任务的准确性。
核心特点
与通用的禅道API调用库不同，本Skill直接封装了“按日期批量完成任务”、“基于标准化表格批量创建任务”等贴近实际项目管理流程的高阶操作，并内置了工作日计算和任务类型映射，开箱即用。
注意事项
目前主要面向个人任务管理场景，对于需要复杂权限控制或多项目协同的团队级自动化流程支持有限。
常见问题
如何安全地测试批量创建任务功能？
使用 `create_tasks.py` 脚本时不加 `--execute` 参数，系统会仅预览将要创建的任务详情，而不会实际写入禅道。
任务表中的“人员姓名”如何对应到禅道账号？
需要通过 `--username-mapping` 参数提供一个JSON字符串，将中文姓名映射到禅道登录账号，例如：`"{\"张三\":\"zhangsan\"}"`。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/zentao-ai-agent/raw/index.md 读取 zentao-ai-agent 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/zentao-ai-agent/raw/index.md（查看排版版本）