mcpField
A
axhub-prototype-context

axhub-prototype-context

github.com/lintendo设计与 UI13742 次安装2 天前更新
代码仓库

关于 axhub-prototype-context

axhub-prototype-context 是一项供 AI Agent 使用的技能，用于读取已发布原型中的页面结构、PRD、批注和源代码线索。默认以只读方式获取上下文，并可按要求提交 Axhub Make 评审报告。

主要功能

  1. 01读取原型上下文快照
  2. 02整理目录与 PRD 内容
  3. 03提取批注字段及数量
  4. 04检查图片和源代码交接信息
  5. 05支持按要求提交评审报告

适用场景

  1. 01继续评审带批注的原型
  2. 02在制作工作前了解页面和需求
  3. 03根据源代码清单查找相关文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lintendo/axhub-skills --skill axhub-prototype-context

安装后在 Claude Code 中输入/axhub-prototype-context确认已加载。

附带文件references/review-report-submission.md

详细介绍

带注释的原型上下文

读取带注释原型中已发布的上下文，让 AI Agent 了解其页面、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；需要源代码时，通过 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 解析其中的路径。

评论

支持 Markdown