zentao-task

タスク

重要 — 開始前に必ず Read ツールを使って ../zentao-shared/SKILL.md を読み込んでください。認証、権限処理、設定に関する説明が含まれています

タスク検索のヒント：まず、ユーザーが検索スキルの使用を特に指定しているか、また実際に検索キーワード（タスク名、キーワード、説明の一部など）を提示しているかを確認してください。ユーザーが検索スキルの使用を特に指定している場合、またはタスクの検索キーワードを明確に示している場合は、検索系コマンドを優先してください。ユーザーが検索スキルの使用を特に指定しておらず、意図に検索キーワードがなく、範囲条件（「完了済み」「自分が作成」「自分に割り当て」など）のみの場合は、リスト系の機能（task list）を優先してください。

意図の見分け方に関する補足：「タスクを検索」のような表現は、字面に「検索」とあっても、実際の検索キーワードがなく、本質的には範囲条件を指定している場合は、task list を優先してください。

ユーザーの特定：ユーザーの本人確認が必要な場合、ユーザーが「自分」（「自分に割り当て」「自分が作成」など）について言及しているときは、現在ログインしているユーザーの関連情報を取得してください。

わかりやすい出力：タスクの詳細を出力する際は、ユーザーがクリックして詳細を直接確認できるように、コマンドの戻り値に関連リンクのフィールドがあれば、それも抽出して出力することをおすすめします。

コマンド

• task list — タスクの一覧表示
• task get — タスクの詳細取得
• task create — タスクの作成
• task update — タスクの更新
• task delete — タスクの削除
• task start — タスクの開始
• task pause — タスクの一時停止
• task restart — 一時停止したタスクの再開
• task finish — タスクの完了
• task close — タスクのクローズ
• task estimate — 作業見積もりの記録を追加
• task get-estimate — 見積もり記録の取得

よくあるユースケース

プロジェクトのタスク一覧を表示

# 列出项目所有任务
zentao-cli task list --project 1

# 只看我被指派的任务
zentao-cli task list --project 1 --assigned-to me

タスクの詳細を取得

zentao-cli task get 456

タスクを作成

# 创建简单任务
zentao-cli task create --name "实现登录功能" --project 1 --pri 3

# 创建任务并指定负责人、预估工时
zentao-cli task create --name "代码评审" --project 1 --pri 2 --assigned-to developer-name --estimate 4

タスクを更新

# 更新任务状态
zentao-cli task update 456 --status done

# 更新任务负责人
zentao-cli task update 456 --assigned-to another-user

# 更新任务状态为进行中
zentao-cli task update 456 --status doing

タスクのステータス値

ステータス	説明
wait	待機中
doing	進行中
done	完了
closed	クローズ済み

優先度

レベル	説明
1	最高
2	高
3	中
4	低

エラー処理

よくあるエラー

エラーコード	説明	対処方法
ZEN_NOT_FOUND	タスクが存在しません	タスク ID が正しいか確認してください
ZEN_AUTH_FAILED	認証に失敗しました	ZENTAO_TOKEN が有効か確認してください
ZEN_PARAM_MISSING	パラメーターが不足しています	コマンドのヘルプを参照して必須パラメーターを確認してください

エラー処理の例

# 查看认证状态
zentao-cli auth status

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

注意事項

1. reminder（リマインダー時刻）を設定できるのは、due（期限）が設定されている場合のみです
2. start（開始時刻）と due（期限）を同時に設定する場合、開始時刻は期限以前でなければなりません
3. タスク ID はグローバルに一意な識別子であり、タスク番号ではありません（例：t104121）
4. 削除操作は取り消せません。実行前にユーザーの意図を確認してください

使用例

# 列出项目所有任务
zentao-cli task list --project 1

# 只看我被指派的任务
zentao-cli task list --project 1 --assigned-to me

# 获取任务详情
zentao-cli task get 456

# 创建任务
zentao-cli task create --name "实现登录功能" --project 1 --pri 3

# 更新任务状态
zentao-cli task update 456 --status done

フィールドリファレンス

フィールド	型	説明
id	u64	タスク ID
name	string	タスク名
project	u64	所属プロジェクト ID
execution	u64	所属する実行／イテレーション ID
assigned_to	string	担当者のユーザー名
status	string	タスクのステータス
pri	u64	優先度
estimate	float	見積もり作業時間（時間）
consumed	float	消費済み作業時間（時間）
start	string	開始時刻
due	string	期限
created_by	string	作成者
created_date	string	作成日時