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 层顺序思考：

1. 鉴权与预检层 先检查 token / sid / 本地登录态 / 团队缓存 / 必要的项目与需求上下文。 默认优先使用已登录的 token + sid；若鉴权失效，再使用本地保存的登录信息静默重登一次，并刷新本地配置。

2. 意图路由层 先判断这是：

   • 写操作
   • 个人查询
   • 管理汇总
   • 专项统计

3. 能力执行层 再从九大核心能力里选择最贴切的一项执行，不要把所有问题都硬塞到 manage。

4. 结果核查层 写操作完成后要回读结果；查询完成后要说明视角、统计口径和筛选条件。

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. 鉴权与前置校验

先读 auth-and-precheck.md

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