ZenTao AI 助手 (zentao-mcp-代理)
When to use this 技能
当你（大语言模型）需要代替用户在禅道中查阅待办、分配任务、填报工时或操作任务状态机时，请必须启用此扩展包提供的 工具 集合。依托我们的 MVC+RESTful 混动底层架构，你可以基于用户授权，越过繁杂的分页与项目界面，进行事项的统筹处理。
💡 AI 最佳实践指引 (For LLM AI)
作为 AI 助手，当用户提出下述意图时，请严格按照指引调用底层提供的 4 大 工具 工具：
触发意图：用户询问
“看看张三手头有什么活”、“最近哪些线上 Bug 延期了”。
调用动作：调用 获取仪表盘。
参数指南：通过 type（task/bug/story）切换类型，通过 状态（doing, wAIt, done）过滤状态。
✅ my tasks / my bugs / my stories：查询当前登录用户的待办，完全可用。
✅ --as签名 <他人>：支持跨人员查看官方指派视角，适合主管查岗或交叉核对。
✅ manage --users <成员列表>：管理视角聚合查询，适合主管查看单人或团队当前任务池。
1.1 管理聚合视角补充规则 (Management 仪表盘)
触发意图：用户说
“帮我看张三今天要盯哪些任务”、“把我们组这几个人的任务、需求、Bug 汇总出来”。
调用动作：优先调用 manage 对应的管理聚合能力。
参数指南：
--users 支持账号、中文名、多人逗号分隔。
--type 支持 tasks/stories/bugs/all。
默认口径为 当前未完成项 + 当日完成/关闭项；若用户指定时间窗口，再追加 --date-from 与 --date-to。
--状态 支持逗号分隔，如 doing,wAIt。
--deadline-from、--deadline-to 可用于筛选临期任务；--overdue-only 可用于只看已延期项。
管理视角中的状态是跨类型语义映射，不是简单字面匹配：例如 doing,wAIt,done 会自动覆盖任务、需求、Bug 各自对应的待处理/已完成状态。
--team-name <团队名> 可直接复用本地缓存的团队成员列表，适合固定小组的日常巡检。
输出中的“总计”会严格跟随当前 --type 查询口径，并额外展示过滤条件，避免将定向查询误读为全量统计。
my tasks --as签名 <账号> 与 manage --users <成员> 不可混为一谈：前者是官方指派地盘，后者是管理汇总视角。
输出展示优先使用中文友好字段，方便用户直接阅读，也便于大模型后续做晨报、周报和催办摘要。
触发意图：用户说
“把网关排查的活儿发给李四，给半天时间”，但未指明具体项目或迭代时。
调用动作：组合调用 获取Projects -> 获取ActiveExecutions -> (若无当期迭代则调用 创建Execution) -> 最后发起 创建Task。
参数指南：务必先明确当前的迭代/执行 execId。如不确定，先查询项目列表及其下挂载的近期执行。如有必要跨月，可智能创建一个当月的新冲刺。派单时，可以直接传入真实的中文 name、as签名ee 和工时 estimate（默认2小时）。底层已内置自动修补禅道必填项和账号映射转换。若是“从需求拆分任务”，可直接传 storyId + projectId；命令行工具 会优先复用当月执行，若不存在则复制上个执行配置后自动创建。
补充约定：创建任务时可直接传 pri 和 desc；若未传 pri，默认按 3 级优先级创建。
- 一句话快捷报工 (Seamless Effort 记录ging)
触发意图：用户说
“给 10452 任务登记 2 个小时的内容撰写工时”。
调用动作：调用 添加Estimate。
参数指南：必须带有精确的 taskId、耗时 consumed 以及备注 work。本接口底座已修复了禅道坑爹的报工幽灵丢失漏洞，直接确保工时准确入库！
- 极简状态流转 (状态 Machine Control)
触发意图：用户说
“那个 Bug 修完了，状态转给测试组长张三”。
调用动作：按实体类型调用 更新Task、更新Story、更新Bug 工具组合。
检索补充：若用户只给了任务名称而没有给 taskId，可先调用 findTasksByName 在当前账号、指定成员或团队范围内检索任务，拿到准确 ID 后再继续状态流转或报工。
- 智能链接提取 (Smart Link Resolver)
触发意图：用户在群聊或对话中甩出一条任意掺杂着链接的文本（如
“帮我看看这个任务什么情况：http://zentao.yourcompany.com/task-view-123.html”）。
调用动作：提取包含网址在内的整段内容传给底层解析封装。你可以依此瞬间掌握该链接指向的任务/缺陷/需求等一切核心骨干状态。
- 派发前负荷参考雷达 (Workload Radar)
触发意图：用户在派发新任务前问
"李四目前有多少任务在手上，还有多少工时要做？"，或者"帮我看看张三和李四谁比较空"。
调用动作：调用底层 获取MemberLoad，传入一个或多个成员账号/中文名，并发拉取其处理中任务与剩余工时后统一汇报。
重要原则：这是纯参考数据，不应自动阻断或拒绝 派单操作。应将数据呈现给用户，由用户决定是否继续分派。
团队缓存补充：若用户已保存团队别名，可优先使用 --team-name 复用团队成员列表。
口径补充：该能力已复用管理视角底座，输出会显式标明是任务还是 Bug。
展示补充：输出中应包含 P1 未完成任务数量、任务平均进度，以及每条任务的单项进度百分比，帮助用户快速判断团队负荷质量。
- 停滞单据排查 (Stagnant Tasks Patrol)
触发意图：用户询问
"张三有什么任务一直没动" 或 "帮我看看团队里有没有什么任务超过一周没人管"。
调用动作：提取目标成员列表与停滞天数阈值（默认3天），调用 获取StagnantTasks 返回按停滞时长排序的停滞单据清单。
- 晨会综合沙盘 (Morning Standup Radar)
触发意图：用户说
"帮我出今天的晨会通报" 或 "看看今天团队有哪些紧急的事项"，并提供团队成员列表。
调用动作：调用 获取Morning检查，传入团队成员列表，返回三类清单：overdue（已超期）、dueSoon（今明到期）、highPriority（高优悬空）。
输出要求：请将三类数据以清晰简明的格式呈现，使用 emoji 区分风险等级（🔴超期 / 🟡临期 / 🟠高优），方便用户直接转发晨会通报。
团队缓存补充：固定团队可先通过 team save 建立别名，后续晨会直接使用 --team-name。
口径补充：该能力已复用管理视角底座，预警清单中会显式区分任务、需求、Bug。
过滤补充：无截止日期的需求默认不纳入晨会预警，避免将弱时效事项误判为晨会风险。
参数补充：支持通过 --pri-max 调整晨会关注的高优阈值，例如传 1 时仅保留 P1 事项；输出中同时展示粗粒度进度百分比，便于快速判断推进程度。
- 自动化周报摘要 (Weekly Synthesis)
触发意图：用户说
"帮我出本周周报素材"、"汇总团队这周交付了哪些重点事项"，并提供团队成员列表或团队名。
调用动作：调用 获取WeeklySynthesis，传入团队成员列表与时间窗，返回两类核心清单：stories（高优需求交付）与 bugs（重大缺陷修复），同时附带成员维度交付汇总。
输出要求：优先展示统计范围、本周截止窗口、总交付 / 高优交付 / 本周待完成任务 与成员交付汇总；仅在用户明确需要逐条清单时，再补充任务、需求、Bug 详情。
团队缓存补充：固定团队优先通过 team save 建立别名，周报直接复用 --team-name。
参数补充：支持 --date-from、--date-to 自定义统计窗口，支持 --pri-max 收敛到更高价值的交付事项；Bug 严重程度默认跟随该阈值，--severity-max 仅保留为兼容补充参数。
视图补充：支持 --view summary|full，默认使用 summary。当用户只需要给大模型投喂底稿时，直接走默认值；当用户明确需要逐条清单时，再切换为 full。
周窗口补充：周报会按自然周自动识别周一到周日；即使在周四、周五、周六查询，也会自动纳入本周周末截止但尚未完成的任务。
💻 安全与环境依赖说明 (环境 & Security)
⚠️ 运行须知： 这是一个受限的主流大模型端桥接应用。为保障您的操作合规，本扩展不会在未授权状态下进行任何风险调优或系统篡改。
如果您需要在本地命令行使用或验证此工具，可以进行全局安装或扩展装载：
# 全局安装 命令行工具 工具
npm 安装 -g @chenish/zentao-mcp-代理
# 或者通过 npx 挂载大模型工具 (如平台需要)
npx 技能s 添加 @chenish/zentao-mcp-代理
作为环境依赖底座，首次使用必须执行授权鉴权：
zentao-命令行工具 记录in --url "https://xxxxx.com/zentao" --account "<账号>" --pwd "<密码>"
本插件已将极其复杂的禅道 API 与路由封装为极简的指令集，可用作日常 命令行工具：
🔥 地盘全视界 (My 仪表盘)
# 基础：默认拉取指派给我的待办任务
zentao-命令行工具 my tasks
# 分类：拉取指派给我的缺陷清单
zentao-命令行工具 my bugs
# 分类：拉取指派给我的需求清单 (聚合：一键获取我名下的业务需求)
zentao-命令行工具 my stories
# 管理视角：跨权限查看张三地盘上的所有任务 (查岗：跨项目查阅张三的任务列表)
zentao-命令行工具 my tasks --as签名 张三
# 精准过滤：查看张三目前正在进行中的任务 (过滤：精确提取张三进行中的代办)
zentao-命令行工具 my tasks --as签名 张三 --状态 doing
# 管理聚合视角：汇总张三当前相关的任务、需求、缺陷
zentao-命令行工具 manage --users 张三
# 管理聚合视角：只看团队成员当前任务池
zentao-命令行工具 manage --users 张三,李四 --type tasks
# 管理聚合视角：只看单人的缺陷
zentao-命令行工具 manage --users 张三 --type bugs
# 管理聚合视角：只看进行中的任务
zentao-命令行工具 manage --users 张三 --type tasks --状态 doing
# 管理聚合视角：同时看进行中与待开始任务
zentao-命令行工具 manage --users 张三 --type tasks --状态 doing,wAIt
# 团队缓存视角：直接按团队名查询
zentao-命令行工具 manage --team-name "规划组"
# 时间窗管理视角：补入指定日期内完成/关闭的任务
zentao-命令行工具 manage --users 张三,李四 --date-from 2026-03-12 --date-to 20
by