zentao

ZenTao AI Assistant

このスキルを使用するタイミング

ユーザーが禅道での未完了タスクの確認、チームの作業項目の集計、タスクの作成、ステータスの変更、朝会・週報の素材作成を依頼した場合に、このスキルを有効にします。

「コマンドをそのまま表示する手引き」ではなく、「ワークフロー型のスキル」として優先的に使用してください。

出力に関するルール

• デフォルトでは、基盤となる機能を直接呼び出してタスクを完了し、zentao-cli ... コマンドを最終回答としてユーザーに返さないでください。
• ユーザーが「コマンドを教えて」「CLI の例を見せて」「手動で実行／トラブルシューティングしたい」と明示した場合に限り、cli-examples.md を読み、内容を引用してください。
• 機能を呼び出す前に、必ず auth-and-precheck.md を読んでください。
• 書き込み操作に関わる場合は、先に write-workflows.md を読んでください。
• 照会、集計、朝会、週報、リスクスキャンに関わる場合は、先に query-routing.md を読んでください。
• 「作成／my／manage」の簡潔な判断ガイドが必要な場合に、decision-rules.md を読んでください。
• 照会タスクでは、まず自然言語で要約し、その後に構造化されたリストを提示してください。
• 管理結果では、中国語ユーザーに分かりやすい項目名を優先し、内部フィールド名をそのままユーザーに提示しないでください。
• このスキルが利用可能か確認するだけの場合は、照会または操作を実行して結果を報告し、コマンドをそのまま表示しないでください。

多層ワークフロー

常に次の4層の順序で考えてください。

1. 認証と事前確認層 token／sid／ローカルのログイン状態／チームキャッシュ／必要なプロジェクトと要件のコンテキストを確認します。 デフォルトでは、ログイン済みの token + sid を優先します。認証に失敗した場合は、ローカルに保存されたログイン情報を使って一度だけ静かに再ログインし、ローカル設定を更新します。

2. 意図の振り分け層 まず、次のどれに該当するか判断します。

   • 書き込み操作
   • 個人の照会
   • 管理集計
   • 専門的な統計

3. 機能の実行層 次に、9つのコア機能から最も適切なものを選んで実行します。すべての質問を無理に manage に当てはめないでください。

4. 結果の確認層 書き込み操作の完了後は結果を再取得して確認します。照会の完了後は、視点、集計基準、絞り込み条件を説明します。

9つのコアツールの一覧

A. 照会と洞察

1. 全体の未完了タスクを俯瞰

• 用途：自分、特定の人、特定のチームのタスク／要件／Bugを確認します。
• 主な機能：my、manage
• 主な違い：
  • my = 公式な割り当て／個人の担当範囲
  • manage = 管理集計／チーム全体の概要

2. リンクのスマート解析

• 用途：ユーザーがタスク、要件、Bugのリンクを直接送ってきた場合に使用します。
• 主な機能：view
• 主なルール：
  • リンクがある場合は、ユーザーに ID の提示を求める前にリンクを解析してください。
  • 「完了しているか」「すでに完了したか」「このタスクは現在どのような状態か」とユーザーが尋ねた場合は、view を優先してください。
  • 複数人の並行タスクと判定された場合は、「個人の完了状態」と「全体の完了状態」を必ず併せて出力してください。
  • 全体の doing/wait/done だけを根拠に結論を出さないでください。

3. 朝会の自動報告

• 用途：今日の朝会、リスク報告、今日・明日の期限、期限超過リストに使用します。
• 主な機能：morning-check
• 主なルール：
  • これは専門的な統計機能であり、一般的な manage に置き換えないでください。
  • 朝会レポートには、タスク／要件／Bugを含む「作業項目の集合」が出力されることがあります。
  • 朝会レポートにある期限超過の項目をすべて「期限超過タスク」と表現しないでください。
  • 「特定の人に現在、期限超過タスクがいくつあるか」を確認する場合は、タスクの基準で個別に再確認してください。

4. 割り当て前の負荷参考レーダー

• 用途：タスクを割り当てる前に、誰に余裕があるか、誰がすでに多くのタスクを抱えているかを判断します。
• 主な機能：load
• 主なルール：これは参考情報であり、割り当てを自動的に却下するものではありません。

5. 停滞した項目の調査

• 用途：長期間更新されていない進行中の作業項目を調査します。
• 主な機能：stagnant
• 主なルール：重要な指標は「停滞日数＋最終更新日時」であり、単純なステータスの絞り込みではありません。

6. 自動週報の要約

• 用途：チーム週報、今週の納品内容の集計、今週の未完了項目に使用します。
• 主な機能：weekly-synthesis
• 主なルール：これは週報用の統計であり、一般的な管理集計ビューとは異なります。

B. 書き込みと実行

7. 対話形式での高速なタスク作成

• 用途：通常のタスク作成、要件からのタスク分割、複数人のタスク作成に使用します。
• 主な機能：task create、照会／作成の実行
• 主なルール：
  • まず要件に関連付けるかどうかを判断します。
  • まずプロジェクトと実行の関連付けを確認します。
  • 複数メンバーの場合、デフォルトでは並行作業として扱います。

8. 対話形式での簡単な作業実績登録

• 用途：所要時間の記録、作業内容の補足に使用します。
• 主な機能：task effort
• 主なルール：現在安定している機能は「所要時間＋任意の説明」です。

9. シンプルなステータス変更

• 用途：開始、完了、クローズ、引き継ぎ、名前でタスクを検索してからのステータス変更に使用します。
• 主な機能：task update、story update、bug update、task find
• 主なルール：まず対象を正しく特定してから、ステータスを変更するか引き継ぎを行います。

C. 基本的な補助機能

10. チーム名簿のキャッシュ

• 用途：固定チームで朝会、週報、負荷確認、管理集計を繰り返し行う場合に使用します。
• 主な機能：team save、team list、team show、team delete
• 主なルール：
  • 固定チームの場合は、まずチームの別名を保存してください。
  • 以降は --team-name の再利用を優先してください。

11. 中国語名の自動マッピング

• 用途：ユーザーがシステムアカウントではなく、中国語の氏名を入力した場合に使用します。
• 主な機能：メンバーのマッピング、担当者のマッピング、チームメンバーのマッピング
• 主なルール：
  • 中国語の氏名は、基盤となるアカウントに自動マッピングすることを優先してください。
  • 書き込み操作でも照会でも、マッピングしてから実行を続けてください。

12. 人に分かりやすいリンクとウェブページ遷移の認識

• 用途：ユーザーが長いテキスト、タスク名、タスク ID を提示し、禅道のウェブページをすばやく開きたい場合に使用します。
• 主な機能：view、task find
• 主なルール：
  • テキスト内に禅道のリンクがある場合は、直接解析することを優先してください。
  • ユーザーがタスク名だけを提示した場合は、まずタスクを検索し、クリック可能なウェブリンクを返すことができます。
  • ユーザーがタスク ID だけを提示した場合は、対応するウェブリンクを直接返すことができます。

必読のリファレンス

1. 認証と事前確認

まず auth-and-precheck.md を読んでください。

2. 書き込み操作のワークフロー

タスクの作成、要件の分割、引き継ぎ、ステータス変更、作業実績の登録に関わる場合は、まず write-workflows.md を読んでください。

3. 照会と統計の振り分け

my、manage、view、morning-check、load、stagnant、weekly-synthesis に関わる場合は、まず query-routing.md を読んでください。

4. 簡潔な判断の補足

簡潔な補足が必要な場合に、decision-rules.md を読んでください。

cli-examples.md を読むタイミング

次のような場合に限り、cli-examples.md を読んでください。

• ユーザーが CLI コマンドまたは手動操作の手順を明示的に求めている場合。
• 開発者によるローカルでの連携テスト、受け入れ確認、トラブルシューティングが必要な場合。
• 特定のパラメーター名、コマンドの組み合わせ、ヘルプの例を確認する必要がある場合。

通常は、このファイル内のコマンドをそのままユーザーに返さないでください。

Current limitations

• task effort --taskId <id> --desc "..." 这种仅写说明不填耗时的形态，在当前禅道环境中页面历史不会稳定落备注。
• story update --storyId <id> --status active 在当前禅道环境中尚未稳定生效。

Installation note

如果用户明确要安装或人工验证，可提示先安装并登录：

• 安装包：@chenish/zentao-mcp-agent
• 首次使用前先完成登录授权
• 具体命令写法见 cli-examples.md