teamwork-child

teamwork-child スキル

このワークツリーは親issueのsub-issueとして作成された。実際の作業内容・進め方は、通常どおり他のスキル・エージェント設定・ユーザー指示に従ってよい。このスキルはそれらを一切上書きせず、実行フローも規定しない。 以下の4つの義務のみを追加で負う。

義務1: 対応開始前のdescriptionセット

このsub-issueへの対応を開始する前に、必ずoretachi_set_descriptionでこのワークツリーの1行説明をセットする。 descriptionが空だとメインウィンドウのカード一覧でこのワークツリーが何をしているのか分からなくなる。

oretachi_set_description(project_dir: <このワークツリーのルート絶対パス>,
  description: "<このsub-issueで進める作業全体の目的を1行で>")

• plan modeかどうかを問わない。 auto modeなどプランを挟まずいきなり実装へ入る場合も、最初のファイル変更より前にセットすること。
• sub-issueのタイトルをそのまま流用してよいが、15〜40文字程度の1行に収める。
• セットするのは作業全体の目的であり、サブタスクの進行やレビュー対応では更新しない。目的そのものが変わったときだけ更新する。

義務2: 報告

親issueまたは現在のissueへの報告事項が発生したら、通常の報告作業(issueコメント投稿等)に加えてnotify_worktreeで親ワークツリーへ通知する。

• issueへコメントした場合: 本文は省略し、コメントのURLのみをbodyに入れる。

  notify_worktree(worktree_name: <自分のワークツリー名>, kind: "general",
    event_kind: "worktree.message", body: "<コメントURL>")
  

  • event_kind: "worktree.message"を指定することで、親issueワークツリーが購読している場合に配送される(宛先は購読側=親issueワークツリーが決めるため、worktree_nameは表示トースト用であり配送先には無関係)。
  • 自分のワークツリー名が分からない場合はoretachi_get_worktree_status(query: <git branch --show-current の結果>)で確認する。
• ユーザーが購読機能を認識しており、issueコメントを介さず直接ワークツリーへの報告を指示された場合に限り、notify_worktreeの通知のみでよい(issueコメント投稿は不要)。

義務3: 停止条件

issue本文に## 停止条件セクションがある場合、そこに書かれた各項目は人の判定が必須であり、AIだけで先に進めてはいけない。

1. 該当する状態に達したら、作業を止めて自ワークツリー上でユーザーに確認する。 notify_worktreeで自分自身に通知してユーザーを呼び戻す:

   notify_worktree(worktree_name: <自分のワークツリー名>, kind: "approval",
     body: "<どの停止条件に達したか>")
   

2. 確認が取れたら、どの停止条件をクリアしたかを親へ報告する(親が計画フロー図のチェックを付けるため)。書式は固定で、issue本文のHTMLコメントにあるid(<!-- sc-142-1 -->)を[]に入れる:

   notify_worktree(worktree_name: <自分のワークツリー名>, kind: "general",
     event_kind: "worktree.message", body: "停止条件クリア: [sc-142-1]「<停止条件のテキスト>」→ <ユーザーの判断内容>")
   

   idが本文に書かれていない場合は[]を省略し、テキストだけで報告する。
3. issue本文のチェックボックスも - [x] に更新する(親がworktree.closed時にここを突き合わせる)。

子の停止条件は子の上で解決する。親を止めるためのものではない。 親は子の停止を受け取っても止まらず流れを継続する仕様なので、ユーザーへの確認は必ず自ワークツリーで行うこと。