zentao

zentao（ZenTao CLI）

⚠️ 非推奨です。 公式にメンテナンスされている zentao-cli と、そのスキル easysoft/zentao-skills（REST v2、MCP サーバー内蔵、より幅広いモジュールをカバー）の使用を推奨します。次のコマンドで移行できます：npx skills add easysoft/zentao-skills。このスキルは既存ユーザー向けに引き続き利用できます。

このスキルを使う場面

ユーザーから禅道／ZenTaoに関する質問があった場合は、次の内容を含め、このスキルを使ってください。

• バグ：一覧表示、自分のバグ、統計、取得、作成、解決、担当者割り当て、コメント、クローズ、有効化
• タスク：一覧表示、取得、作成、開始、完了、一時停止、クローズ
• ストーリー：一覧表示、取得、作成
• TODO：一覧表示、取得、作成、完了、クローズ
• プロダクト、プログラム、プロジェクト、実行
• 計画、リリース、ビルド
• テストケース、テストタスク、テストスイート
• ドキュメントとドキュメントライブラリ
• ユーザーと部門
• 課題とリスク
• ログイン、whoami、セルフテスト、JSON エクスポート

ユーザーからの典型的な依頼は次のとおりです。

• 「禅道のバグ／タスク／ストーリー／TODOを調べて」
• 「バグの解決率を集計して」／「各プロダクトのバグ解決状況を見せて」
• 「プロダクト、プロジェクト、実行、バージョン、計画、ビルドを確認して」
• 「テスト計画、テストケース、テストスイートを調べて」
• 「ドキュメントライブラリ／ドキュメント／部門／ユーザーを確認して」
• 「課題／リスクを調べて」
• 「禅道にログインして」／「禅道の接続を確認して」

インストール

npx skills add leeguooooo/zentao-mcp -y -g
pnpm i -g @leeguoo/zentao-mcp

代替手段：

npm i -g @leeguoo/zentao-mcp
npx -y @leeguoo/zentao-mcp --help

skills add はスキル定義をインストールします。通常の利用には、引き続き CLI が PATH 上で zentao として利用できる必要があります。

ログイン

zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami

重要：--zentao-url には通常 /zentao を含める必要があります。

クイックスタート

zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
zentao self-test

機能一覧

1 件のレコードを扱う場合や状態を変更する場合は単数形のコマンドを、一覧を取得する場合は複数形のコマンドを使ってください。

zentao login
zentao whoami
zentao self-test
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bugs stats --product-ids 1,2 --group-by product|person [--from DATE] [--to DATE]
zentao bug get|create|resolve|assign|comment|close|activate ...
zentao tasks list --execution 25
zentao task get|create|start|finish|pause|close ...
zentao stories list --product 3
zentao story get|create ...
zentao todos list|get|create|finish|close ...
zentao plans list|get ...
zentao releases list|get ...
zentao testcases list|get ...
zentao testtasks list|get ...
zentao testsuites list|get ...
zentao docs libs|list|get ...
zentao users list
zentao departments list
zentao issues list|get ...
zentao risks list|get ...

認証と出力のルール

• すべてのコマンドで、保存済みのログイン設定から認証情報を読み込めます。
• フラグも使用できます：--zentao-url、--zentao-account、--zentao-password
• 環境変数も使用できます：ZENTAO_URL、ZENTAO_ACCOUNT、ZENTAO_PASSWORD
• 呼び出し元が機械可読の生データを必要とする場合は、--json を追加してください。
• ZenTao の URL には通常 /zentao のサフィックスが必要です。

バグのコマンド

zentao bugs list --product 6
zentao bugs mine --scope assigned --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title" [--severity 3] [--pri 2] [--type codeerror] [--steps "..."] [--assigned-to account] [--opened-build trunk]
zentao bug resolve --id 1329 --resolution fixed [--resolved-build trunk] [--assigned-to kelly] [--comment "..."]
zentao bug assign --id 1329 --assigned-to rd-yitong [--comment "..."]
zentao bug close --id 1329 [--comment "..."]
zentao bug activate --id 1329 [--assigned-to account] [--comment "..."]
zentao bug comment --id 1329 --comment "已确认，等待修复"

解決値：fixed、bydesign、duplicate、postponed、notrepro、willnotfix、tostory、external

バグの統計

# 按产品统计解决率
zentao bugs stats --product-ids 1,2 --group-by product

# 按人员统计解决率（按实际解决人 resolvedBy 分组）
zentao bugs stats --product-ids 1,2 --group-by person

# 按产品统计指定时间段内的解决数量
zentao bugs stats --product-ids 1,2 --group-by product --from 2026-01-01 --to 2026-04-09

# 按人员统计指定时间段内的解决数量
zentao bugs stats --product-ids 1,2 --group-by person --from 2026-03-01 --to 2026-03-31

# JSON 输出
zentao bugs stats --product-ids 1,2 --group-by product --json

• --product-ids は必須で、カンマ区切りで指定します
• --group-by は product または person を指定できます。デフォルトは product です
• --from／--to を指定しない場合は解決率を出力し、期間を指定した場合はその期間中の解決件数を出力します
• 人物別の集計では、resolvedBy（実際の解決担当者）でグループ化します

タスクのコマンド

zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name" [--assigned-to account] [--pri 3] [--estimate 8] [--type devel] [--desc "..."]
zentao task start --id 388 [--consumed 2] [--left 6]
zentao task finish --id 388 [--finished-date "2026-04-08"] [--consumed 8]
zentao task pause --id 388
zentao task close --id 388 [--comment "done"]

ストーリーのコマンド

zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title" [--spec "description"] [--pri 2] [--estimate 3] [--type story] [--assigned-to account]

TODO のコマンド

zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name" [--type custom] [--date 2026-04-08] [--begin 09:00] [--end 10:00] [--pri 3] [--desc "..."] [--assigned-to account]
zentao todos finish --id 1
zentao todos close --id 1

プロダクト、プログラム、プロジェクト、実行のコマンド

zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list

プロダクト計画とリリース

zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1

テストのコマンド

zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1

組織とドキュメント

zentao users list
zentao departments list
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1

課題とリスク

zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1

JSON 出力

すべてのコマンドで --json を指定すると、完全な JSON ペイロードを取得できます。

zentao whoami --json
zentao bugs list --product 6 --json
zentao task get --id 388 --json
zentao users list --json
zentao issues get --id 1 --json

推奨する実行手順

ユーザーの実務を支援する場合は、次の順序を推奨します。

1. CLI が利用できることを確認します：zentao --help
2. 認証情報があることを確認します：zentao whoami
3. 認証に問題がある可能性がある場合は、次を実行します：zentao self-test
4. 依頼に答えられる最も用途を絞ったコマンドを使います。
5. 後続の自動化で構造化出力が必要な場合は、--json を追加します。