用途:把应用代码转化为覆盖整体功能的实操漫游指南,从代码中推导出应用分区(导航)、角色、任务、变体与用户旅程,每个任务生成一份漫游文档,直到覆盖所有路由与页面,未覆盖的会记录为缺口并说明原因。
主要能力:分区以全屏地图呈现;选中某条旅程时高亮其有序路径;每份漫游可在地图旁打开,步骤按角色以卡片展示。重新检查应用被设计为归属 E2E 测试自动完成。
使用方式:依赖 Node.js 20.19+ 与 npm,用于查看器及 npm run check、npm run index。需在根目录 AGENTS.md(缺失则新建)加入标准规则语句;根目录 CLAUDE.md 存在且未引入 AGENTS.md 时也需加入。Agent 需能读取应用代码并写入仓库文件。先读 walkthrough-contract.md,再按意图匹配配方:创建读 creating-walkthroughs.md,引导读 guiding-walkthrough.md,更新读 updating-walkthroughs.md。初始化时整体复制 assets/index.md、assets/walkthrough.md 与 assets/app/(含查看器、npm run check、npm run index)。契约文档涵盖根目录、布局、模型、输入、覆盖度、视角、索引与漫游前置数据、设置树、切分、写作与步骤格式、同步、查看器、检查清单。
适用场景:无漫游需新建、新增任务、需要实况引导用户走查某条漫游或旅程、应用变更或需重构漫游时。
限制:资料未提供收费、价格、平台适用范围与效果保证等信息。