axhub-prototype-context

注釈付きプロトタイプのコンテキスト

注釈付きプロトタイプから公開されたコンテキストを読み取り、AI エージェントがそのページ、PRD、注釈、利用可能なソースを理解したうえで、レビューまたは本番作業を続行できるようにします。ユーザーから Axhub Make にレビュー報告を送信するよう依頼されない限り、ページは読み取り専用として扱います。

ワークフロー

1. Playwright、Browser、Chrome、またはページの JavaScript を評価できる同等のツールで、指定された注釈付きプロトタイプの URL を開きます。
2. アプリがレンダリングされるまで待ち、続いて window.__AXHUB_ANNOTATION_SOURCE__ があるかどうかをしばらく確認します。
3. その値を評価して返します。オブジェクトを変更したり、window に何かを書き戻したりしないでください。
4. 値が見つからない場合は、URL、ページタイトル、関連するコンソールエラー、および注釈付きプロトタイプのコンテキストスナップショットが公開されていないことを報告します。
5. ユーザーから Axhub Make にレビュー報告を送信するよう依頼された場合は、references/review-report-submission.md を読みます。

最小限のページ評価：

await page.waitForFunction(() => window.__AXHUB_ANNOTATION_SOURCE__, { timeout: 10000 });
const source = await page.evaluate(() => window.__AXHUB_ANNOTATION_SOURCE__);

報告する内容

• source.directory のディレクトリ／PRD の概要。
• ディレクトリノードのうち、type: "markdown" のエントリに含まれる Markdown または PRD。
• 注釈の数、および重要なノードフィールド：id、title、pageId、locator、annotationText、aiPrompt、color、controls。
• source.source がある場合は、ソースの引き継ぎ情報。root と manifest を報告します。ソースが必要な場合は、manifest と関連ファイルを root 経由で読みます。
• images.length を確認し、画像が添付されているかどうかを明記します。ユーザーから依頼されない限り、画像はダウンロードしないでください。

データ形式

type AnnotationSourceRuntimeSnapshot = {
  directory: AnnotationDirectory | null;
  nodes: AnnotationNode[];
  source?: {
    root?: string;
    manifest?: string;
  };
};

• directory.nodes はプロトタイプのツリーです。ノードの種類は folder、route、link、markdown です。
• nodes は、現在のページ、選択状態、色フィルターに左右されない、すべての注釈のリストです。
• 各注釈ノードには、id、index、任意の title、任意の pageId、locator、aiPrompt、annotationText、hasMarkdown、color、images、任意の controls、createdAt、updatedAt が含まれます。
• source は、ソースコードを見つけるための参照情報に限られます。ソースを含めて公開された HTML では、manifest は source/manifest.json を指します。そのパスは source.root を基準に解決してください。