用途
zentao-tour 的定位不是"教程"而是"陪逛":像同事带你在禅道里随手点点看看,顺便把 zentao-cli 的常用姿势用出来。它面向首次接触禅道、想上手禅道与 zentao-cli 的用户,让用户顺着自己的角色在真实禅道环境里边聊边动手,熟悉产品、需求、计划、任务、Bug、测试用例等模块的增删改查与状态流转。
主要能力
- 以聊天方式引导用户上手禅道,核心手感是"同事口吻、不要教程腔",不编号"任务 1/2/3",不把每个动作都包成仪式感的"小结"。
- 开场时顺口点一下大致路线,每做完一小段顺手回顾一两句、抛个好奇心钩子接到下一段。
- 悄悄做工具就绪检查:直接跑 zentao profile 确认账号,失败时参考 overview.md 引导安装/登录。
- 确认能连上禅道后,检查已登录的禅道账号和角色,通过 AskQuestion 让用户选择角色(产品经理 / 项目经理 / 测试 / 开发 / 公司高管),并附"我随便看看"兜底项。
- 根据选择读取对应的叙事文件:产品经理 roles/pm.md、项目经理 roles/pjm.md、测试 roles/test.md、开发 roles/dev.md、公司高管 roles/executive.md;"我随便看看"则先让用户描述当下最关心什么,从 5 个文件中选最接近的一个,并从用户提到的点切入。
- 把叙事文件当作"线索地图"而非"剧本",剧情按用户当下的兴奋点走。
- 内部可用 TodoWrite 追踪用户进度,但不主动把待办清单读给用户听,除非用户询问。
- 所有 create / update / delete / 状态流转(close/resolve/finish 等)前先以日常口气征得同意,优先使用简写命令。
- 出错时把错误码翻译成用户关心的事,并主动给下一步操作建议。
使用方式
触发技能后,技能不会立刻抛流程,而是先用一两句话打招呼,点明"我会陪你在你自己的禅道里随手逛一逛,顺手把 zentao-cli 几个常用招数用出来"。随后悄悄做工具就绪检查,直接跑 zentao profile,并顺口说一句类似"我先确认下是哪个账号……"。如果失败,参考 overview.md 的指引引导安装/登录,但口气仍是"那我们先把账号接上"。
确认能连上禅道后,检查已登录的禅道账号和角色,顺势问用户一句日常化的问题来确定下一步角色,例如"你在团队里平时更像哪种角色?比如想点子的、排期的、找 Bug 的、写代码的,还是看全局的?",并使用 AskQuestion 给出 5 个选项(产品经理 / 项目经理 / 测试 / 开发 / 公司高管),附一个"我随便看看"的兜底项。
根据选择读取对应的叙事文件,进入后把文件当作"线索地图"而非"剧本"。每次最多抛一个动作或问题,让对话像聊天而不是讲课。需要用户做开放性选择时,给 3–4 个一眼能懂的候选(用 AskQuestion),外加一个"我自己想一个"的口子。
写操作前先"自然地"说一声,例如"那我就用 zentao product create --name="..." 帮你建出来,OK?",而不是"我将要执行以下命令,请确认:"。简写命令优先(参照 zentao-cli 技能),不要生成冗长 JSON 除非字段特别多。
用户任意时刻说"够了 / 换一个"都尊重。结束时用一两句非正式的话回顾他真正做过的动作,并轻轻抛一个问题:要不要换个角色再逛一圈?要不要顺手把刚才演示产生的数据清掉?如果用户想清数据,用 zentao <module> delete <id> --yes 帮他删,每条前再确认一次。
适用场景
- 用户首次接触禅道、想上手禅道与 zentao-cli。
- 用户希望按自己的团队角色(产品经理、项目经理、测试、开发、公司高管)在真实禅道环境中熟悉相关模块。
- 用户想以轻松聊天的方式了解产品、需求、计划、任务、Bug、测试用例等模块的增删改查与状态流转。
限制
- 技能依赖 zentao-cli 与可连接的禅道环境;若 zentao profile 失败,需先按 overview.md 指引完成安装/登录。
- 所有写操作(create / update / delete / 状态流转)均需用户同意后执行。
- 错误码处理方式:E1001 / E1004 提示登录过期需重登(zentao login -s ... -u ... -p ...);E2001 模块名不认,跑 zentao help 查看正确写法;E2002 ID 找不到对应对象,列出供挑选;E2003 缺必填字段,查看 zentao <module> help 补齐;E2006 权限不够,需换账号或找管理员开通;E5001 网络或服务超时,稍后重试或确认禅道地址。
- 参考资料包括 overview.md(禅道与 zentao-cli 速览、安装、MCP 配置、就绪自检)、禅道官网 / 使用手册 / 版本对比、zentao-cli 仓库。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。