@cloudglab/zentao-cli 0.1.3 → 0.1.5

package/skills/zentao-cli/reference/overview.md

@@ -0,0 +1,24 @@
+# 总览
+
+## 这个 skill 做什么
+
+- 用命令行方式操作禅道
+- 默认只 preview，不直接写线上
+- 支持任务、Bug、需求、项目、执行、构建、测试用例、测试单等常用场景
+
+## 推荐工作流
+
+1. 先确认本机是否安装 `zentao`
+2. 如果没有，优先安装或升级本地 `zentao`
+3. 先判断用户问的是普通禅道产品数据，还是业务产品的线上 / 客户反馈 / 生产问题
+4. 如果是线上 Bug，固定按 `reference/bug.md` 里的“市场和售后问题跟踪 + 模块匹配”链路查询
+5. 根据问题类型，去对应 reference 文档找命令
+6. 默认只 preview；写操作必须显式确认
+
+补充：当前发布产物运行时目标为 `Node.js >= 16`；开发 / 构建环境可以更高。
+
+## 适合谁
+
+- 需要命令行操作禅道的人
+- 需要把禅道接入智能体的人
+- 需要在旧版本禅道环境下稳定使用的人

package/skills/zentao-cli/reference/plan.md

@@ -0,0 +1,20 @@
+# Plan
+
+## 查询
+
+```bash
+zentao getProductPlans --productId <productId>
+zentao getPlanDetail --planId <id>
+```
+
+## 关系操作
+
+```bash
+zentao linkStoriesToPlan --planId <id> --storyIds <id1,id2>
+zentao linkBugsToPlan --planId <id> --bugIds <id1,id2>
+```
+
+## 场景
+
+- 查看计划
+- 关联需求 / Bug 到计划

package/skills/zentao-cli/reference/product.md

@@ -0,0 +1,14 @@
+# Product
+
+## 查询
+
+```bash
+zentao getProducts
+zentao getProductDetail --productId <id>
+zentao getProductStories --productId <id>
+```
+
+## 场景
+
+- 查看产品信息
+- 查看产品下需求 / Bug / 用例

package/skills/zentao-cli/reference/project.md

@@ -0,0 +1,14 @@
+# Project
+
+## 查询
+
+```bash
+zentao getProjects
+zentao getProjectDetail --projectId <id>
+zentao getProjectExecutions --projectId <id>
+```
+
+## 场景
+
+- 查看项目
+- 查看项目下执行

package/skills/zentao-cli/reference/statistics.md

@@ -0,0 +1,30 @@
+# Statistics
+
+## 查询
+
+```bash
+zentao getMyTaskStatistics
+zentao getMyBugStatistics
+zentao getMyBugStatistics --productId <productId>
+zentao getMyWeeklyActivity --account <account> --week last
+zentao getMyWeeklyActivity --account <account> --dateRange 上周
+zentao getMyWeeklyActivity --account <account> --dateRange 最近3天
+zentao getMyWeeklyActivity --account <account> --dateRange 2026-05-28
+zentao getMyWeeklyActivity --account <account> --startDate 2026-05-25 --endDate 2026-05-29
+```
+
+## 场景
+
+- 看个人任务统计
+- 看个人 Bug 统计
+- 看指定账号上周 / 本周做了什么：解决 Bug、关闭 Bug、评论补充、指派流转、任务相关动作和每日清单
+
+说明：
+
+- `getMyBugStatistics` 不传 `productId` 时，默认统计跨所有产品“指派给我的 Bug”
+- 传 `productId` 时，只统计指定产品内我的 Bug
+- `getMyWeeklyActivity` 是近似读取：调用禅道旧版动态页面 JSON 获取动态原始数据，再按原始 `originalDate` / `date` 在客户端筛选日期范围，用于快速生成“我某段时间做了什么”清单
+- 日期不要写死为周：优先支持 `--dateRange` 自然语言描述，也支持 `--startDate/--endDate` 和 `--days`
+- `--dateRange` 支持示例：`上周`、`本周`、`今天`、`昨天`、`最近3天`、`3天前`、`2026-05-28`、`2026-05-25到2026-05-29`
+- 未传日期范围时，默认兼容旧参数：`--week last` 映射 `lastWeek`，`--week this` 映射 `thisWeek`
+- bug 转任务去重会优先识别动态记录中的来源 Bug 字段；如果动态记录没有来源 Bug 字段，该任务会按独立任务计数并在结果限制说明中提示

package/skills/zentao-cli/reference/story.md

@@ -0,0 +1,22 @@
+# Story
+
+## 查询
+
+```bash
+zentao getStoryDetail --storyId <id>
+zentao getProductStories --productId <productId>
+zentao searchStories --productId <productId> --keyword <keyword>
+```
+
+## 写入
+
+```bash
+zentao updateStory --storyId <id> --confirm true
+zentao changeStory --storyId <id> --confirm true
+```
+
+## 场景
+
+- 查看需求
+- 修改需求内容
+- 变更需求状态

package/skills/zentao-cli/reference/task.md

@@ -0,0 +1,21 @@
+# 任务 Task
+
+## 查询
+
+```bash
+zentao getMyTasks
+zentao getTaskDetail --taskId <id>
+```
+
+## 写入
+
+```bash
+zentao updateTask --taskId <id> --status done --confirm true
+zentao finishTask --taskId <id> --confirm true
+```
+
+## 场景
+
+- 看我的待办
+- 改任务状态
+- 完成任务

package/skills/zentao-cli/reference/testcase.md

@@ -0,0 +1,20 @@
+# TestCase
+
+## 查询
+
+```bash
+zentao getProductTestCases --productId <productId>
+zentao getTestCaseDetail --testCaseId <id>
+```
+
+## 写入
+
+```bash
+zentao createTestCase --productId <productId> --title <title> --type feature --confirm true
+zentao updateTestCase --testCaseId <id> --confirm true
+```
+
+## 场景
+
+- 创建 / 修改测试用例
+- 查看产品用例列表

package/skills/zentao-cli/reference/testtask.md

@@ -0,0 +1,20 @@
+# TestTask
+
+## 查询
+
+```bash
+zentao getTestTasks --productId <productId>
+zentao getTestTaskDetail --testTaskId <id>
+```
+
+## 写入
+
+```bash
+zentao createTestTask --project <projectId> --productID <productId> --name <name> --build <buildId> --begin <YYYY-MM-DD> --end <YYYY-MM-DD> --confirm true
+zentao updateTestTask --testTaskId <id> --confirm true
+```
+
+## 场景
+
+- 创建 / 修改测试单
+- 查看产品测试单列表