zentao-user

ユーザー（v2）

重要 — 開始する前に、必ず Read ツールを使って ../zentao-shared/SKILL.md を読み込んでください。認証、環境変数、エラー処理について記載されています。

ユーザーの識別方法：ZenTao ではユーザーを数字の ID で識別しますが、タスクや Bug などを割り当てる場合は、account（アカウント名）を使うことがあります。API を呼び出す際は、id と account を区別してください。

ユーザーの本人確認が必要な場合：ユーザーが「自分」（例：「自分に割り当てて」「自分が作成した」）と言った場合は、現在ログインしているユーザーの ID を使用してください。zentao-cli user list で自分のアカウント情報を確認できます。

部門とロール：ユーザーは部門（dept）に所属し、ロール（role）を持ちます。よく使われるロールには、dev（開発）、manager（マネージャー）、qa（テスト）、pd（プロダクト）などがあります。

分かりやすい出力：ユーザーの詳細を出力する際は、識別しやすいように account と id に加えて、realname（氏名）も表示してください。

ユーザーロールの種類

ロール	説明	説明
dev	開発者	開発者
manager	マネージャー	マネージャー
qa	QA／テスト	テスト担当者
pd	プロダクトデザイナー	プロダクトデザイン
op	運用	運用担当者
admin	管理者	管理者

コマンド

• user list — 任意のフィルターを指定してユーザーを一覧表示します
• user get — ID でユーザーの詳細を取得します
• user me — 現在のユーザー情報を取得します
• user create — 新しいユーザーを作成します
• user update — ユーザー情報を更新します
• user delete — ユーザーを削除します

よくあるユースケース

シナリオ 1：すべてのユーザーを検索する

# 列出系统中的所有用户
zentao-cli user list

シナリオ 2：部門でユーザーを検索する

# 查看某部门下的所有用户
zentao-cli user list --dept 1

# 组合筛选：某部门的开发人员
zentao-cli user list --dept 1 --role dev

シナリオ 3：ロールでユーザーを検索する

# 查看所有开发人员
zentao-cli user list --role dev

# 查看所有测试人员
zentao-cli user list --role qa

シナリオ 4：ユーザーの詳細を取得する

# 通过用户 ID 获取详细信息
zentao-cli user get 123

# 输出包括：账号、姓名、邮箱、部门、角色等

例

# 列出系统中的所有用户
zentao-cli user list

# 查看某部门下的所有用户
zentao-cli user list --dept 1

# 查看所有开发人员
zentao-cli user list --role dev

# 通过用户 ID 获取详细信息
zentao-cli user get 123

出力フィールド

フィールド	型	説明
id	u64	ユーザー ID（一意の識別子）
account	string	ログインアカウント名
realname	string	氏名
email	string	メールアドレス（任意）
dept	u64	部門 ID（任意）
role	string	ロール（任意）
phone	string	電話番号（任意）
mobile	string	携帯電話番号（任意）

エラー処理

よくあるエラー

エラーコード	説明	解決方法
ZEN_AUTH_FAILED	Token が無効または期限切れです	ZENTAO_TOKEN の設定を確認してください
ZEN_NOT_FOUND	ユーザーが存在しません	ユーザー ID が正しいか確認してください
ZEN_CONFIG_INVALID	設定が無効です	ZENTAO_URL と ZENTAO_TOKEN を確認してください
ZEN_API_ERROR	ZenTao API がエラーを返しました	サーバーの状態を確認するか、しばらくしてから再試行してください

エラー処理の例

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

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

注意事項

1. id と account の違い：ユーザーは id（数字）と account（アカウント名の文字列）の 2 通りの方法で識別されます。API パラメーターはどちらか一方、または両方を受け付ける場合があるため、区別に注意してください。

2. dept が 0 の場合：部門に所属していないユーザーもいます。その場合、dept フィールドは 0 または空になります。

3. role フィールドの値：role は "dev" や "manager" のような文字列で、数字のコードではありません。--role パラメーターには、完全なロール名の文字列を指定してください。

4. ユーザーが存在しない場合の処理：検索したユーザー ID またはアカウントが存在しない場合、API は空のリストではなくエラーを返します。

5. 一括操作：ZenTao のユーザー管理では主に検索がサポートされており、ユーザーの一括作成／更新はサポートされていません（通常、管理者が Web 画面で操作します）。