plannotator-annotate

Plannotator Annotate

ユーザーがチャット内でインラインレビューする代わりに、Plannotator でドキュメントに注釈を付けたい場合にこのスキルを使います。

通常の注釈やフィードバックの場合に実行します。

plannotator annotate <path-or-url>

ユーザーが生成された計画、仕様書、ドキュメントのレビュー、承認、受け入れ、またはゲート設定を求めた場合に実行します。

plannotator annotate <path-or-url> --gate --json

通常の annotate には Approve ボタンがなく、フィードバックまたはセッションの終了のみをサポートします。--gate が指定されていない限り、承認操作ができると約束してはいけません。--json は出力形式を変更するだけで、単独では承認機能を有効にしません。

動作：

1. Bash でコマンドを起動します。
2. ブラウザーでのレビューが完了するまで待ちます。
3. 注釈が返された場合は、それに直接対応します。
4. フィードバックがないままセッションが終了した場合（出力が空、または "decision": "dismissed" を含む JSON オブジェクトの場合）は、1 文でその旨を伝えて終了します。作業を開始してはいけません。セッションの終了は承認ではありません。
5. --gate セッションでは、承認にメモが付いている場合があります。"feedback" フィールドを含む "decision": "approved" の結果（--json を指定しない場合は「Approved with Notes」メッセージ）が返された場合は、そのメモを読み、以降の作業に反映します。ただし、その内容に基づいてドキュメントを修正してはいけません。これらはガイダンスであり、変更依頼ではありません。
6. 引数をファイル、URL、フォルダーに解決できなかったというメッセージがコマンドから返された場合は、ユーザーがどの対象を指しているのかを判断し、その具体的なパスまたは URL を指定して自分でコマンドを再実行します。

シェルコマンドをチャットに貼り付けるようユーザーに求めてはいけません。自分でコマンドを実行してください。