bots

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bots

Bots

This skill puts the user's Grok Bots on their site. A prompt run inside Grok collects the chosen Bots and their copy links, then the site gets one data file, a physics pile, cards and an org chart page.
此 skill 会将用户选择的 Grok Bots 放到其站点上。在 Grok 内运行一段 prompt,收集选定的 Bots 及其复制链接,随后站点会获得一个数据文件、一个物理堆叠效果、一组卡片和一个组织结构图页面。

Exact physics, only the Bots the user picks

精确的物理效果,只包含用户选择的 Bots

The marks in marks.js and the values in pile.js are exact. The copy comes from the Bots themselves and is trimmed, never invented. It applies whenever Grok Bots are shown on a site.
Living eyes and their reactions belong to
avatar
. Label case and word counts belong to
copy
. Surfaces, hover, focus, theme and sound cues belong to
defaults
. Easing and durations outside the pile belong to
motion
, and contrast belongs to
color
. Building in the project's own components belongs to
reuse
. Opening the result belongs to
verify
, and committing belongs to
ship
.
marks.js 中的标记和 pile.js 中的数值必须精确。文案来自 Bots 自身,并经过精简,绝不臆造。凡在站点上展示 Grok Bots,均适用这些要求。
有生命感的眼睛及其反应属于
avatar
。标签大小写和字数控制属于
copy
。界面层级、悬停、焦点、主题和声音提示属于
defaults
。堆叠效果之外的缓动和时长属于
motion
,对比度属于
color
。使用项目自有组件进行构建属于
reuse
。打开并检查结果属于
verify
,提交则属于
ship
。

1. Run the Grok round

1. 运行 Grok 轮次

Give the user the prompt in grok.md to paste into their primary Bot. It lists every Bot, waits for the user's picks, has each picked Bot clean and describe itself, then hands over a publish checklist.
Only the Bots the user picked go on the site. A Bot added because it looked good is
bots-user-picks
.
Wait for the JSON array it returns. When the user pastes setups directly instead, read those the same way.
将 grok.md 中的 prompt 交给用户,让其粘贴到主 Bot 中。该 prompt 会列出所有 Bot、等待用户选择,让每个被选中的 Bot 整理并介绍自己,然后交付发布检查清单。
只有用户选中的 Bots 才会进入站点。仅因某个 Bot 看起来不错就将其加入,属于
bots-user-picks
。
等待它返回 JSON 数组。如果用户改为直接粘贴配置内容,也以相同方式读取。

2. Strip what is private

2. 移除隐私信息

Check every entry again, whatever the Bots already removed. Strip emails, phone numbers, addresses, other people's names, clients, employers, private projects, internal links, keys, tokens, account details, memory and personal facts.
When unsure, leave it out and list it at the end. A client name kept because it seemed harmless is
bots-strip-private
.
A copy link comes only from a published template the user pasted back. A link written from a guessed pattern or a Bot's id is
bots-real-links
.
无论 Bots 已经移除了哪些内容,都要再次检查每个条目。移除电子邮件地址、电话号码、地址、他人的姓名、客户、雇主、私有项目、内部链接、密钥、token、账户信息、memory 和个人事实。
如果不确定,则将其省略,并在最后列出。因看起来无害而保留客户名称,属于
bots-strip-private
。
复制链接只能来自用户粘贴回来的已发布模板。根据猜测的 URL 模式或 Bot 的 id 写出的链接,属于
bots-real-links
。

3. Write one data file

3. 写入单一数据文件

All Bots live in one typed file, such as
data/bots.ts
, one entry per Bot. Areas, shapes and colours are
as const
unions, and
shareUrl
and
video
are optional. Bots spread across components is
bots-one-file
.
Each entry holds a title of 2–3 words, one line of description and 3–5 short items it does. Routines read in plain words with a time, such as "Daily idea drop, 9am", and tools are short names. A paragraph pasted from the Bot's instructions is
bots-entry-shape
.
The areas are the user's own sidebar sections in Grok, named and ordered as they are there. The entry marked
lead
is the primary Bot.
Shape and colour come from each Bot's published page, as grok.md describes. A shape or colour picked by eye from a screenshot is
bots-page-marks
.
所有 Bots 都存放在一个带类型的文件中,例如
data/bots.ts
,每个 Bot 占一个条目。areas、shapes 和 colours 使用
as const
联合类型,
shareUrl
和
video
为可选字段。将 Bot 文案分散在多个组件中,属于
bots-one-file
。
每个条目包含一个 2–3 词标题、一行描述,以及 3–5 个简短的功能项。日常安排(routines)应以通俗文字描述并附上时间,例如“每日灵感投放,上午 9 点”;工具(tools)使用简短名称。直接粘贴自 Bot 指令的段落,属于
bots-entry-shape
。
areas 是用户在 Grok 侧边栏中的自有分区,名称和顺序均与那里一致。标记为
lead
的条目是主 Bot。
形状(shape)和颜色(colour)来自各 Bot 的已发布页面,正如 grok.md 所描述。仅凭截图目测选择 shape 或 colour,属于
bots-page-marks
。

4. Draw each Bot in its own mark

4. 使用各自的标记绘制 Bot

Copy marks.js beside the components. Each Bot is drawn in the shape and colour it has in Grok, from
MARKS[shape].path
and
markEyes(shape)
, with fills from
MARK_COLORS
. A generic avatar or an initial in a circle is
bots-real-marks
.
Black takes the page's text colour for the body and its background for the eyes, so it flips with the theme. Give the eyes life with
avatar
.
将 marks.js 复制到组件旁边。每个 Bot 都按其在 Grok 中的形状(shape)和颜色(colour)绘制,使用
MARKS[shape].path
和
markEyes(shape)
,填充色来自
MARK_COLORS
。使用通用头像或在圆形中放置首字母,属于
bots-real-marks
。
对于黑色 Bot,身体采用页面的文字颜色,眼睛采用页面背景色,因此会随主题切换。使用
avatar
赋予眼睛生命力。

5. Build the pile

5. 构建堆叠

The home page gets a section titled "Grok Bots" holding one card. Inside it sits a 300px stage, 340px under 480px wide, and every Bot as an absolutely placed piece. Shuffle the order with a seeded random so the server and client agree.
Copy pile.js beside the component and add
matter-js
. Call
createPile
once the pieces mount and
destroy
on unmount.
Each body is the mark's convex hull from
markHull
, so stars rest on their points and blobs roll. Circles for every shape is
bots-hull-bodies
.
A drag pulls the Bot through a spring while the world keeps stepping, so it shoves its neighbours. Pausing the world during a drag is
bots-drag-pushes
. Pieces take
touch-action: none
and the stage
pan-y
, so the page still scrolls.
Bots squash against contacts and stretch along their velocity, clamped and normalised to keep their area. A squash that grows the Bot or flips it inside out is
bots-jelly-keeps-area
.
A shake throws every Bot up 3–7px a frame and sideways up to 6, never enough to leave the stage. A phone shake does the same once iOS grants motion access from the button tap. A shake that throws Bots out of view is
bots-shake-stays-in
.
on.bump
passes a soft hit to the avatar as a blink and a hard hit as a spin.
on.sound
plays a low thud, 150Hz falling to 64Hz over 70ms, only once a grab has unlocked audio. A pile that makes sound before the user touches it is
bots-quiet-until-touched
.
A tap shows the Bot's title as a pill linking to its card, above the Bot or below it near the top. A drag past 6px opens nothing, and a tap elsewhere closes it. A drag that also opens the name is
bots-tap-names
.
The loop runs only while the stage is on screen and something still moves or wobbles. A loop that keeps running once the pile sleeps is
bots-sleep-when-still
.
Under reduced motion,
pile.js
runs the drop offline and draws the settled pile once. A shake reshuffles instantly. A pile that still tumbles is
bots-settle-when-reduced
.
Under the stage sit two equal buttons: Shake Bots on a quiet grey surface and View Bots in the solid primary style, linking to the Team page. A lone icon button in the stage corner is
bots-two-actions
.
首页新增一个标题为“Grok Bots”的区块,区块中放置一张卡片。卡片内有一个 300px 的舞台;在页面宽度小于 480px 时,舞台宽度为 340px。每个 Bot 都是一个绝对定位的元素。使用带种子的随机数打乱顺序,使服务器和客户端得到一致结果。
将 pile.js 复制到组件旁边,并添加
matter-js
。在所有元素挂载后调用一次
createPile
,卸载时调用
destroy
。
每个刚体都采用
markHull
生成的标记凸包,因此星形会以尖端支撑,团块则可滚动。所有 shape 都使用圆形刚体,属于
bots-hull-bodies
。
拖动会通过弹簧拉动 Bot,同时物理世界继续步进,因此它能推开邻近元素。拖动期间暂停物理世界,属于
bots-drag-pushes
。各元素采用
touch-action: none
,舞台采用
pan-y
,因此页面仍可滚动。
Bot 在接触时会被挤压,并沿速度方向拉伸;通过限幅和归一化保持其面积不变。挤压导致 Bot 体积增大或发生内外翻转,属于
bots-jelly-keeps-area
。
摇动时,每个 Bot 每帧向上抛出 3–7px,横向最多抛出 6px,始终不会离开舞台。手机摇动操作也会产生同样效果,但前提是从按钮点击触发并已获得 iOS 的动作访问权限。摇动导致 Bots 离开视野,属于
bots-shake-stays-in
。
on.bump
将轻微碰撞作为眨眼传给
avatar
,将强烈碰撞作为旋转传入。
on.sound
播放低沉撞击声,频率从 150Hz 在 70ms 内降至 64Hz,且只有在用户抓取并解锁音频后才能播放。用户尚未触碰时堆叠就发出声音,属于
bots-quiet-until-touched
。
轻触会显示 Bot 标题,标题以胶囊形标签链接到其卡片,位置在 Bot 上方,或靠近顶部时位于其下方。拖动距离超过 6px 时不会打开任何内容;轻触其他位置则会关闭它。拖动同时打开名称,属于
bots-tap-names
。
动画循环仅在舞台处于屏幕内且仍有元素移动或晃动时运行。堆叠静止后循环仍持续运行,属于
bots-sleep-when-still
。
在减少动态效果(reduced motion)偏好下,
pile.js
离线运行落下过程,并一次性绘制静止后的堆叠。摇动会立即重新排列。reduced motion 下 Bots 仍然翻滚,属于
bots-settle-when-reduced
。
舞台下方放置两个等宽按钮:“摇动 Bots”使用安静的灰色表面,“查看 Bots”使用实心主色样式,并链接到 Team 页面。舞台角落仅放一个图标按钮,属于
bots-two-actions
。

6. Build the cards

6. 构建卡片

BotCard
shows the mark, the title and a two-line description. Opening it shows what it does, its routines, its tools as small tags and an optional muted looping clip. Cards in a row share one height.
Copy This Bot opens the share link in a new tab and says so to screen readers. A Bot with no link shows no button. A disabled Link Coming Soon button is
bots-no-dead-copy
.
BotCard
显示标记、标题和两行描述。打开后会显示该 Bot 的功能、日常安排(routines)、作为小标签展示的工具(tools),以及可选的静音循环视频片段。同一行中的卡片高度一致。
“复制此 Bot”会在新标签页中打开分享链接,并向屏幕阅读器说明这一点。没有链接的 Bot 不显示按钮。显示一个禁用的“链接即将推出”按钮,属于
bots-no-dead-copy
。

7. Lay out the Team page as an org chart

7. 将 Team 页面布局为组织结构图

The lead Bot sits alone at the top. A hairline drops to a row of area headings, and each area's Bots stack beneath their heading. Under 560px it becomes one column with the line down the left edge.
When the areas will not fit side by side at the page's width, use that one-column tree at every width. Each area branches off the line with an elbow, and its Bots sit in a grid beneath.
Draw the lines with 1px borders in the border token. Areas as stacked grids with no lead and no lines is
bots-org-chart
.
Register the page wherever the site lists pages, such as the sitemap, the navigation and any markdown mirror.
主 Bot 单独位于顶部。一条极细连接线向下连接到一行 areas 标题,每个 area 下的 Bots 堆叠在其标题下方。宽度低于 560px 时,布局改为单列,连接线沿左边缘向下延伸。
如果按页面宽度无法将 areas 并排容纳,则在所有宽度下都使用这种单列树状布局。每个 area 通过肘形连接线从主线分支,其 Bots 以网格形式排列在下方。
使用 border token 中的 1px 边框绘制连接线。若只是将 areas 排列成堆叠网格,既无 lead 也无连接线,属于
bots-org-chart
。
在站点列出页面的所有位置注册该页面,例如 sitemap、navigation 和任何 markdown mirror。

8. Open it and report

8. 打开并报告

Open the home page and the Team page in both themes, then shake, drag and tap the pile.
Finish with three lists: the files created or changed, every detail stripped or left out as unsure, and the Bots still missing a link. Under that last list, give the Grok steps that make a link. Ending on "done" with none of these is
bots-list-what-is-missing
.
在两种主题中打开首页和 Team 页面,然后摇动、拖动和轻触堆叠。
最后给出三组列表:已创建或修改的文件;所有被移除或因不确定而省略的细节;仍缺少链接的 Bots。在最后一组列表下方,给出在 Grok 中生成链接的步骤。如果未列出上述内容,却以“完成”收尾,属于
bots-list-what-is-missing
。

The pair

成对规则

Every check is a pair. The broken line sits beside the line that replaces it.
RuleBrokenReplacement
bots-user-picks
All 25 Bots added because the list was thereOnly the Bots the user named in round 1
bots-strip-private
"Books calls with Sarah at Acme""Books calls"
bots-real-links
https://x.ai/bot/sleep-coach
, built by hand
The link the user copied after Publish
bots-one-file
Bot copy inlined in three componentsOne entry per Bot in
data/bots.ts
bots-entry-shape
A 90-word description from the Bot's instructions"Guards a steady bedtime and a calm wind-down."
bots-real-marks
An initial in a grey circleThe Bot's own shape and colour from
marks.js
bots-page-marks
shape: "clover"
guessed from a sidebar icon
shape: "cloud"
read from the Bot's x.ai page
bots-hull-bodies
Bodies.circle
for every Bot
Body.create({ vertices })
from
markHull(shape)
bots-drag-pushes
if (dragging) return
before
Engine.update
A spring
Constraint
and the world still stepping
bots-jelly-keeps-area
scale(1.4, 0.8)
that grows the Bot
The matrix clamped and divided by its determinant's root
bots-shake-stays-in
y: -(8 + Math.random() * 10)
y: -(3 + Math.random() * 4)
bots-quiet-until-touched
A thud on the first drop at page loadSound only once a grab has unlocked audio
bots-tap-names
A drag that ends with the name openNames on taps under 6px of travel
bots-sleep-when-still
requestAnimationFrame
forever
The loop stopped once every body sleeps and nothing wobbles
bots-settle-when-reduced
Bots tumbling under reduced motionThe settled pile drawn once, shakes reshuffle instantly
bots-two-actions
A shuffle icon in the stage cornerShake Bots and View Bots, side by side
bots-no-dead-copy
A disabled Link Coming Soon buttonNo button until the link exists
bots-org-chart
Three stacked grids of cardsThe lead on top, a line to each area, Bots beneath
bots-list-what-is-missing
"Added the Bots page"Files, stripped details and Bots missing links
每项检查都由一对规则组成:错误示例与正确替代方案成对呈现。
规则错误示例替代方案
bots-user-picks
因列表中列出了全部 25 个 Bots 而将它们全部加入只加入用户在第 1 轮中指定的 Bots
bots-strip-private
“与 Acme 的 Sarah 预约通话”“安排通话”
bots-real-links
手工拼出的
https://x.ai/bot/sleep-coach
用户在 Publish 后复制的链接
bots-one-file
Bot 文案内联在三个组件中在
data/bots.ts
中为每个 Bot 设置一个条目
bots-entry-shape
一段来自 Bot 指令的 90 词描述“守护规律作息与平静的睡前流程。”
bots-real-marks
在灰色圆形中显示首字母使用 Bot 在
marks.js
中对应的形状和颜色
bots-page-marks
根据侧边栏图标猜测
shape: "clover"
从 Bot 的 x.ai 页面读取
shape: "cloud"
bots-hull-bodies
对每个 Bot 都使用
Bodies.circle
使用
markHull(shape)
生成
Body.create({ vertices })
bots-drag-pushes
在
Engine.update
之前执行
if (dragging) return
使用弹簧
Constraint
,并让物理世界继续步进
bots-jelly-keeps-area
使用会使 Bot 变大的
scale(1.4, 0.8)
对矩阵进行限幅,并除以其行列式的平方根
bots-shake-stays-in
y: -(8 + Math.random() * 10)
y: -(3 + Math.random() * 4)
bots-quiet-until-touched
页面加载时首次落下就发出撞击声只有在用户抓取并解锁音频后才播放声音
bots-tap-names
一次拖动结束时名称仍处于打开状态位移小于 6px 的轻触才打开名称
bots-sleep-when-still
永久运行
requestAnimationFrame
所有刚体休眠且无晃动后停止循环
bots-settle-when-reduced
reduced motion 下 Bots 仍在翻滚一次性绘制静止后的堆叠,摇动时立即重新排列
bots-two-actions
在舞台角落放置一个洗牌图标按钮将“摇动 Bots”和“查看 Bots”并排放置
bots-no-dead-copy
显示一个禁用的“链接即将推出”按钮链接存在之前不显示任何按钮
bots-org-chart
三组纵向堆叠的卡片网格主 Bot 位于顶部,各 area 通过连接线分支,Bots 位于其下
bots-list-what-is-missing
“已添加 Bots 页面”列出文件、已移除的细节和缺少链接的 Bots

Reporting

报告

Severity.
HIGH
is a private detail on the page, a Bot the user did not pick or a link that was not copied from Grok.
MEDIUM
is a frozen pile while dragging, a shake that loses Bots, a Bot turning inside out, motion under reduced motion or a dead copy button. Circle bodies, a loop that never sleeps, sound before a touch, a flat grid instead of the chart or a missing finish list is also
MEDIUM
.
LOW
is a long description, a guessed shape or colour, a lone corner button or a name that opens on a drag.
Format. One finding per root cause:
file:line - [rule-id] what is wrong
Then a
Rule | Count | Severity
summary.
Block
when any
HIGH
remains,
Approve
otherwise. Mark a Bot whose setup you could not read as
Not verified
.
严重程度。
HIGH
表示页面上出现隐私细节、用户未选择的 Bot,或链接不是从 Grok 复制而来。
MEDIUM
表示拖动时堆叠冻结、摇动时丢失 Bots、Bot 发生内外翻转、在 reduced motion 下仍显示运动效果,或出现无效的复制按钮。所有 shape 都使用圆形刚体、循环永不休眠、用户触碰前发声、以平面网格代替组织结构图,以及缺少最终清单,也属于
MEDIUM
。
LOW
表示描述过长、形状或颜色靠猜测、角落仅有一个按钮,或拖动时错误打开名称。
格式。 每个根本原因只写一项发现:
file:line - [rule-id] what is wrong
然后给出
Rule | Count | Severity
汇总。如果仍有任何
HIGH
,则标记为
Block
;否则标记为
Approve
。无法读取其配置的 Bot 标记为
Not verified
。