zentao-bug

バグ（v2）

重大 — 開始前に、必ず Read ツールを使用して ../zentao-shared/SKILL.md を読み込んでください。このファイルには、認証、環境変数、エラー処理、ステータス値の定義が含まれています。

重大度の判断方法：ZenTao のバグの severity（重大度）は 1～5 の 5 段階で、1 が最も重大（システムクラッシュ、データ損失）、5 が最も低い段階（機能の提案）です。バグの作成時は、実際の状況に応じて適切なレベルを選択してください。

• severity=1：システムクラッシュ、機能が完全に利用不可、データ損失
• severity=2：主要機能が動作しない、明確な回避策がある
• severity=3：一般的な不具合、代替手段がある
• severity=4：軽微な問題、インターフェースや操作感に関する問題
• severity=5：機能の提案／改善項目

ステータスと解決策：バグには、active（アクティブ）／resolved（解決済み）／closed（クローズ済み）の 3 つの主なステータスと、それぞれに対応する resolution があります。resolved ステータスのバグには resolution（fixed/duplicate/notrepro/wonfix/bysdesign）の指定が必要です。closed ステータスにするには、まず resolved にしてからクローズします。

割り当てとステータスの変更：バグの作成後、bug update で開発担当者に割り当てることができます。バグが修正されるとステータスは resolved になり、クローズが確認されると closed になります。

わかりやすい出力：バグの詳細を出力する際は、ユーザーが直接クリックして確認できるよう、バグの URL リンク（ZenTao の Web UI アドレス）もあわせて出力することをおすすめします。

バグのライフサイクル

active (激活) ──[修复]──> resolved (已解决) ──[确认]──> closed (已关闭)
    │                         │
    │<────[重打开]─────────────┘
    │
    └──[转为设计/需求]──> changed (已变更)

ステータス遷移ルール

現在のステータス	遷移先	操作
active	resolved	修正完了、resolution を設定
active	closed	直接クローズ（wonfix/bysdesign などの場合）
resolved	active	バグを再オープン
resolved	closed	修正を確認し、バグをクローズ
closed	active	再アクティブ化

重大度レベル

レベル	名前	説明	例
1	Critical	システムクラッシュ、データ損失、機能が完全に利用不可	ページを開けない、重要なデータの損失
2	Major	主要機能が動作しない、回避策がある	中核となるボタンをクリックしても反応しない
3	Normal	一般的な不具合、代替手段がある	重要度の低い機能の異常
4	Minor	軽微な問題、インターフェースや操作感に関する問題	テキストがすべて表示されない
5	Wishlist	機能の提案／改善項目	ある機能の追加を希望

コマンド

• bug list — 製品のバグ一覧を取得
• bug get — バグの詳細を取得
• bug create — 新しいバグを作成
• bug update — バグのフィールドを更新
• bug resolve — バグを解決
• bug confirm — バグを確認
• bug close — バグをクローズ
• bug activate — バグをアクティブ化
• bug delete — バグを削除

よくある使用例

シナリオ 1：製品のアクティブなバグをすべて検索する

# 按产品 ID 列出所有激活状态的 Bug
zentao-cli bug list --product 1 --status active

シナリオ 2：新しいバグを作成する

# 创建严重性为 1 的紧急 Bug
zentao-cli bug create --title "用户登录页面崩溃" --product 1 --severity 1 --pri 1

# 创建带有详细复现步骤的 Bug
zentao-cli bug create \
  --title "上传头像失败" \
  --product 1 \
  --severity 2 \
  --pri 2 \
  --steps "1. 进入个人资料页\n2. 点击上传头像\n3. 选择图片后无响应"

シナリオ 3：バグのステータスと解決策を更新する

# 标记 Bug 为已修复
zentao-cli bug update 123 --status resolved --resolution fixed

# 指派给开发人员
zentao-cli bug update 123 --assigned-to developer-name

# 重打开 Bug
zentao-cli bug update 123 --status active

シナリオ 4：担当者でバグを絞り込む

# 查看指定人员的待办 Bug
zentao-cli bug list --product 1 --assigned-to developer-name

エラー処理

よくあるエラー

エラーコード	説明	解決策
ZEN_AUTH_FAILED	Token が無効または期限切れです	ZENTAO_TOKEN の設定が正しいことを確認してください
ZEN_NOT_FOUND	バグが存在しません	Bug ID が正しいことを確認してください
ZEN_CONFIG_INVALID	設定が無効です	ZENTAO_URL と ZENTAO_TOKEN を確認してください
ZEN_API_ERROR	ZenTao API がエラーを返しました	サーバーの状態を確認するか、しばらくしてから再試行してください
ZEN_PARAM_MISSING	必須パラメーターが不足しています	すべての必須パラメーターが指定されていることを確認してください

エラー処理の例

# 遇到 auth 错误时检查认证状态
zentao-cli auth status

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

例

# 列出产品 1 下的所有激活状态的 Bug
zentao-cli bug list --product 1 --status active

# 创建 Bug
zentao-cli bug create --title "用户登录页面崩溃" --product 1 --severity 1 --pri 1

# 标记 Bug 为已修复
zentao-cli bug update 123 --status resolved --resolution fixed

# 查看指定人员的待办 Bug
zentao-cli bug list --product 1 --assigned-to developer-name

注意点

1. severity と pri の違い：severity は不具合の重大度（1～5）、pri は優先度（1～4）を表します。両者は異なる概念なので、バグの作成時にはそれぞれ設定する必要があります。

2. resolution は status に依存します：resolution の設定が必要なのは status=resolved の場合のみです。fixed/duplicate/notrepro/wonfix/bysdesign は一般的な解決策です。

3. closed ステータスには直接遷移できません：バグを active から直接 closed にすることはできません。まず resolved にしてから closed にする必要があります。ただし、wonfix/bysdesign などの場合は例外です。

4. steps フィールドの形式：再現手順は、複数行を \n で区切ることをおすすめします。読みやすく、解析しやすくなります。

5. 要件やプロジェクトとの関連付け：バグの作成時に、--story と --project を使って既存の要件やプロジェクトに関連付けることができます。