hiro-task-manager-cli

Hiro Task Manager CLI

ユーザーが hirotm CLI を通じて Hiro Task Manager を操作し、タスク、タスクリスト、タスクボードを管理したい場合に、このスキルを使用します。

このスキルを使用する場面

• タスクの作成、更新、削除。
• タスクリストの作成、更新、削除。
• ボードの管理。
• タスク、リスト、ボードの一覧表示、検索、フィルタリング。
• タスク、リスト、ボードを操作できるよう、Hiro Task Manager サーバーを管理する。
• タスク、リスト、ボードの削除、完全削除、復元（破壊的操作を参照）。

破壊的操作

次のコマンドは破壊的であり、現在のターンでユーザーから明示的かつ曖昧さのない依頼がない限り、決して実行してはいけません。

• tasks purge、lists purge、boards purge — 永続的に削除され、復元できません。

ソフト削除（tasks delete、lists delete、boards delete）は、次の条件を満たす場合に限り実行できます。

1. エージェントが対象エンティティをユーザーに表示し（show、describe、または list を使用）、それが正しい対象であることを確認している。
2. その特定のエンティティを削除するというユーザーの意図が明確である。

誤って削除されたエンティティを再作成するより、常に先に trash で確認し、restore で復元してください。

対応している破壊的コマンドは、まず --dry-run を付けて実行し、ユーザーの確認後にのみ --yes を付けて再実行してください。

デフォルトの操作手順

1. 目的のワークスペースのルートに移動します。
2. まず Hiro Task Manager サーバーが起動していることを確認します。
3. 操作対象となるボード、リスト、またはタスクを見つけます。
4. 検索または一覧表示／フィルタリングを使って、対象エンティティを絞り込みます。
5. 自分を識別するため、すべてのコマンドで（識別情報）を使用します。
6. 利用可能なすべてのデータを使い、最小限かつ安全な変更を行います。
7. 変更後の状態を表示します。

基本ルール

• すべての操作に hirotm CLI コマンドを使用します。
• コマンドまたはサブコマンドのヘルプを表示するには、--help を使用します（例：boards --help、boards describe --help）。
• 例やドキュメントへのリンクが必要な場合は、hirotm --help とサブコマンドのヘルプを優先します。
• 目的のワークスペースのルートからコマンドを実行します。
• 変更を行う前に、現在の状態を確認します。
• ページ分割された読み取りや検索で、まず件数だけが必要な場合は、--count-only を優先します。
• 変更を行うコマンドには --client-name を指定し、変更の実行者を追跡できるようにします。
• 削除、完全削除、構造変更は慎重に扱います。
• 削除、完全削除、ボード構造の変更では、まず --dry-run を優先し、実行の準備ができた段階でのみ --yes を付けて再実行します。
• 1 回の実行でプレーンな出力を確認しやすい場合は、--no-color を使用します。

識別情報

すべてのコマンドで --client-name <your-name> を指定して、自分を識別してください。名前にはエージェント名を反映します。例：Cursor Agent、Github Copilot Agent、Claude Code Agent、Open Code Agent。 名前がわからない場合は、汎用名の「AI Agent」を使用します。

検出

• すべてのボードを一覧表示するには、boards list を使用します。
• すべてのボードまたは一部のボードの詳細を表示するには、boards describe <id-or-slug> を使用します。
• ボード内のタスクを一覧表示し、フィルタリングするには、tasks list --board <board-id-or-slug> を使用します。
• ID がわかっている場合、グローバル ID で 1 行を表示するには、tasks show <task-id> または lists show <list-id> を使用します。

タスクの検索／追加／更新

• ユーザーが既存のタスクについて言及した場合は、tasks list とフィルター、tasks show、または query search を使用して見つけます。
• 必要に応じて、limit、offset、fields、quiet の各オプションを使って、出力を管理し、形式を調整します。
• タスクを追加する場合
  • 優先度、タスクグループ、リリースなど、利用可能な情報を使用します。
  • 適切なタイトル（最大 80 文字）を付け、関連する場合に限り絵文字を追加します。
  • タスクの本文に詳細が含まれる場合は、適切に構成された Markdown 形式の説明を使用します。
  • タスクに設計図が含まれる場合、またはユーザーから依頼された場合は、mermaid 図を使用します。
  • ワークスペース内のドキュメントへのリンクを追加する場合は、ワークスペースのルートからの適切なリンクを使用します。

アクセス

CLI アクセス制御により、エンティティへのアクセスや操作の実行が許可されていない場合は、その状況を説明し、必要な権限を付与するようユーザーに提案してください。CLI アクセス制御を回避しようとしないでください。

エラー

• error テキストを解析するより、機械可読な標準エラー出力の code を優先してください。
• 標準エラー出力に hint が含まれている場合は、それを次の復旧手順として使用してください。
• HTTP/API の失敗には通常、ローカルの引数検証エラーよりも適切な hint が含まれています。

サーバー操作

• server status でサーバーのステータスを確認します。
• server start --background でサーバーを起動します。
• server stop でサーバーを停止します。

参照

• サーバーコマンド - サーバーの起動、停止、ステータスの確認。
• Boards Commands - ボードの作成、更新、削除、一覧表示、説明、設定。
• Lists Commands - ボードのリストの一覧表示、表示、追加、更新、移動、削除、復元、完全削除。
• Tasks Commands - タスクの一覧表示、表示、追加、更新、移動、削除、復元、完全削除。
• Releases Commands - リリースの一覧表示、表示、追加、更新、削除、デフォルト設定。
• Trash Commands - ゴミ箱にあるボード、リスト、タスクの確認。
• Status Commands - ワークフローのステータスとその意味の一覧表示。
• Search Commands - query search によるタスクの全文検索。
• CLI Access Policy - コマンドと cliPolicy の要件、および読み取り／書き込み権限の対応付け。
• Errors and Exit Codes - 終了コード、標準エラー出力のフィールド、一般的な機械可読コード。

安全に関する注意事項

• まず確認してから操作するワークフローを優先してください。
• 重複の可能性がある場合は、作成する前に検索してください。
• hirotm CLI 以外の手段で CLI を迂回しないでください。
• 権限やポリシーによる拒否を尊重し、安全でない方法で回避しようとしないでください。
• 破壊的なコマンドについては、破壊的な操作を参照してください。

参照

• オンラインドキュメント