ZenTao AI Assistant
When to use this skill
当用户希望你代替他在禅道里查询待办、汇总团队事项、创建任务、流转状态、产出晨会/周报素材时，启用这个技能。
优先把它当成“流程型技能”来用，而不是“命令回显手册”。
Output contract
- 默认直接调用底层能力完成任务，不要把
zentao-cli...命令当成最终答复返回给用户。 - 只有当用户明确要求“给我命令”“给我 CLI 示例”“我要手动执行/排查”时，才去读取并引用 cli-examples.md。
- 在任何能力调用前，先读取 auth-and-precheck.md。
- 涉及写操作时，先读取 write-workflows.md。
- 涉及查询、统计、晨会、周报、风险扫描时，先读取 query-routing.md。
- 需要一个紧凑版的“创建 / my / manage”决策提示时，再读取 decision-rules.md。
- 查询类任务优先返回自然语言总结，其次再给结构化清单。
- 管理类结果优先输出中文友好字段，避免把内部字段名直接丢给用户。
- 如果只是为了确认这个技能可用，直接完成查询或操作并汇报结果，不要回显命令。
Layered workflow
始终按下面 4 层顺序思考：
鉴权与预检层先检查 token / sid / 本地登录态 / 团队缓存 / 必要的项目与需求上下文。 默认优先使用已登录的token + sid；若鉴权失效，再使用本地保存的登录信息静默重登一次，并刷新本地配置。意图路由层先判断这是：
- 写操作 - 个人查询 - 管理汇总 - 专项统计
能力执行层再从九大核心能力里选择最贴切的一项执行，不要把所有问题都硬塞到manage。结果核查层写操作完成后要回读结果；查询完成后要说明视角、统计口径和筛选条件。
Nine-core-tools map
A. 查询与洞察
1. 全局待办透视
- 适用：看我自己、看某个人、看某个团队的任务/需求/Bug。
- 主要能力：
my、manage - 关键区分：
- my = 官方指派 / 个人地盘 - manage = 管理汇总 / 团队总览
2. 链接智能解析
- 适用：用户直接甩来任务、需求、Bug 链接。
- 主要能力：
view - 关键规则：
- 有链接时优先先解析链接，不要先要求用户补 ID - 如果用户问“是否闭环”“是不是已经完成”“这个任务现在到底是什么状态”，优先走 view - 如果识别到是多人并行任务，必须同时输出“个人完成态”和“整体闭环态” - 不要只根据整体 doing/wait/done 一句话下结论
3. 晨会自动播报
- 适用：今日晨会、风险播报、今明到期、超期清单。
- 主要能力：
morning-check - 关键规则：
- 这是专题统计，不要退化成普通 manage - 晨报输出的是“事项池”，可能同时包含任务 / 需求 / Bug - 不要把晨报里的全部超期事项都表述成“超期任务” - 如果用户要核对“某个人当前到底有多少个超期任务”，改用任务口径单独复查
4. 派发前负荷参考雷达
- 适用：派单前判断谁比较空、谁的任务已经太多。
- 主要能力：
load - 关键规则：这是参考信息，不自动替用户否决派单。
5. 停滞单据排查
- 适用：排查长期未更新的进行中事项。
- 主要能力：
stagnant - 关键规则：核心口径是“停滞天数 + 最后更新时间”，不是简单状态过滤。
6. 自动化周报摘要
- 适用：团队周报、本周交付汇总、本周待完成项。
- 主要能力：
weekly-synthesis - 关键规则：这是周报统计，不等于普通管理聚合视图。
B. 写入与执行
7. 对话式极速建单
- 适用：普通建任务、从需求拆任务、多人任务创建。
- 主要能力：
task create、执行查询/创建 - 关键规则：
- 先判断是否关联需求 - 先核查项目与执行归属 - 多成员默认多人并行
8. 对话式快捷报工
- 适用：登记耗时、补充工作说明。
- 主要能力：
task effort - 关键规则：当前稳定能力是“耗时 + 可选说明”。
9. 极简状态流转
- 适用：启动、完成、关闭、转交、按名称找任务后再流转。
- 主要能力：
task update、story update、bug update、task find - 关键规则：先找对对象，再做状态流转或转交。
C. 基础辅助能力
10. 团队名单缓存
- 适用：固定团队反复做晨会、周报、负荷检查、管理聚合。
- 主要能力：
team save、team list、team show、team delete - 关键规则：
- 固定团队优先先保存团队别名 - 后续优先复用 --team-name
11. 中文自动映射
- 适用：用户直接输入中文真实姓名，而不是系统账号。
- 主要能力：成员映射、指派映射、团队成员映射
- 关键规则：
- 中文姓名应优先自动映射到底层账号 - 写操作和查询都先做映射，再继续执行
12. 人性化链接与网页跳转识别
- 适用：用户给出大段文本、任务名称、任务 ID，想要快速定位禅道网页。
- 主要能力：
view、task find - 关键规则：
- 文本里出现禅道链接时，优先直接解析 - 用户只给任务名称时，可先检索任务，再返回可点击网页链接 - 用户只给任务 ID 时，可直接返回对应网页链接
Required references
1. 鉴权与前置校验
2. 写操作流程
涉及建任务、拆需求、转交、流转、报工，先读 write-workflows.md
3. 查询与统计路由
涉及 my、manage、view、morning-check、load、stagnant、weekly-synthesis，先读 query-routing.md
4. 紧凑决策补充
需要一个简版补充时再读 decision-rules.md
When to read cli-examples.md
只在下面这些场景读取 cli-examples.md：
- 用户明确要 CLI 命令或手动操作步骤。
- 需要给开发者做本地联调、验收、故障排查。
- 需要核对某个参数名、命令组合或帮助示例。
平时不要默认把该文件里的命令直接返回给用户。
Current limitations
task effort --taskId <id> --desc "..."这种仅写说明不填耗时的形态，在当前禅道环境中页面历史不会稳定落备注。story update --storyId <id> --status active在当前禅道环境中尚未稳定生效。
Installation note
如果用户明确要安装或人工验证，可提示先安装并登录：
- 安装包：
@chenish/zentao-mcp-agent - 首次使用前先完成登录授权
- 具体命令写法见 cli-examples.md