skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
imyuyu/zentao-cli62 installs

zentao-story

禅道(ZenTao) 需求(Story)管理 — 列出、查看、创建、更新需求。当用户说:'查询需求'、'需求列表'、'有哪些需求'、'story 列表'、'查看需求'、'story 详情'、'创建需求'、'新建 story'、'需求变更'、'关闭需求'、'需求状态'、'需求评审'、'禅道需求' 时触发。

How do I install this agent skill?

npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-story
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is designed to manage ZenTao stories using a dedicated CLI tool. It is generally safe but carries a low risk of indirect prompt injection by processing story content that could contain malicious instructions.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

story (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和状态值定义。

Commands

Story Lifecycle

需求在 ZenTao 中有明确的生命周期状态:

draft → active → changed → closed
         ↑         ↓
         └─────────┘ (可重新激活)

Valid Status Transitions

Current StatusValid Next Status说明
draftactive提交审核
activechanged, closed审核通过或关闭
changedactive, closed变更后重新审核或关闭
closedactive重新激活

Story Status Values

Status中文说明
draft草稿需求草稿状态
active活跃已提交审核
changed已变更需求有变更待审核
closed已关闭需求已关闭

Priority Levels

LevelName说明
1最高最高优先级
2高高优先级
3中中优先级
4低低优先级

注意:优先级 0 通常表示未设置优先级。

Story Types

Type中文说明
feature功能新功能需求
enhance增强功能增强
bugfix缺陷Bug 修复
task任务任务类需求
story用户故事用户故事

Story Stage Values

Stage说明
wait未开始
plan已计划
developed已开发
testing测试中
released已发布
closed已关闭

使用前可先运行 zentao-cli story --help 查看完整选项。

Common Use Cases

1. 查看产品下的所有需求

# 列出产品 1 下的所有需求
zentao-cli story list --product 1

# 只看活跃的需求
zentao-cli story list --product 1 --status active

2. 查看特定需求详情

# 获取需求详情(包含描述、预估工时、阶段等)
zentao-cli story get 123

3. 创建新需求

# 基础创建
zentao-cli story create --title "用户登录功能" --product 1 --pri 1

# 完整创建(带类型和预估工时)
zentao-cli story create --title "用户注册功能" --product 1 --pri 1 --type feature --estimate 8

4. 更新需求状态

# 关闭需求
zentao-cli story update 123 --status closed

# 更新优先级
zentao-cli story update 123 --pri 2

# 变更需求状态并指派
zentao-cli story update 123 --status changed --assigned-to developer-name

5. 按项目筛选需求

# 查看项目 1 下的所有需求
zentao-cli story list --product 1 --project 1

Examples

# 列出产品 1 下的所有需求
zentao-cli story list --product 1

# 只看活跃的需求
zentao-cli story list --product 1 --status active

# 获取需求详情
zentao-cli story get 123

# 创建新需求
zentao-cli story create --title "用户登录功能" --product 1 --pri 1

# 关闭需求
zentao-cli story update 123 --status closed

Output Fields

FieldTypeDescription
idu64需求 ID
titlestring需求标题
productu64产品 ID
statusstring需求状态:draft / active / closed / changed
priu8优先级:0-5
categorystring需求类别:feature / requirement / bug / improvement
stagestring当前阶段:wait / plan / developed / testing / released / closed
moduleu64所属模块 ID
assigned_tostring指派人
opened_bystring创建者
estimatef64预估工时(小时)
versionu64版本号(用于乐观锁)

Gotchas

  1. Story ID vs Title:创建需求后返回的是需求 ID(数字),而不是 title,后续操作需要使用 ID。

  2. Status Transition:只有符合状态转换规则的状态变更才会被接受:

    • draft → active:提交审核
    • active → changed/closed:审核动作
    • 错误的转换会返回错误
  3. Version for Updates:更新需求时建议提供 version 字段以实现乐观锁,避免并发更新冲突。

  4. Estimate Unit:--estimate 参数的单位是小时(hours)。

  5. Type vs Category:Story 有 type(story type)和隐含的 category(需求类型),两者可能不同,根据实际业务选择。

  6. Closed Story Reactivation:已关闭的需求可以通过设置为 active 重新激活。

  7. Product Required:创建需求时 --product 参数是必需的,且需求必须归属于某个产品。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/imyuyu/zentao-cli/zentao-story">View zentao-story on skillZs</a>