unicodef1wn/grokbot-field-notes

Grok Bot Field Notes 是一个公共文件、模板和手册集合，由来自 xAI Grok Bot 团队的三名工程师从一次极限构建中提取：他们从一个空仓库开始，在直播中通过自己的代理平台在72小时内发布了一款产品。该仓库是那次运行的精华记录，打包后供任何人将这些规则复制到自己的编码代理中。

谁制作的。 来自 xAI Grok Bot 团队的三名工程师：Roshan Sadanani（产品）、Lauren Tan（工程）、Matt Palmer（开发者体验）。仓库本身提到这是“我从那三天中提取的内容”——虽然 README 没有说明具体是谁整理的，但这是其中一人的提炼成果。

内容包含。 一组分为几个类别的文档：

• 为您自己的代理制定的规则。 AGENTS.md 是一个包含内部规则的单一文件；将其复制到您的仓库根目录，任何读取您仓库的编码代理都会获取这些规则。ANTIPATTERNS.md 列出了在直播构建期间发生的40个故障——每个条目都说明了故障内容、原因以及由此产生的规则。
• 组件库。 agents/ 包含 AGENTS.md 指向的较长参考文件（验证、编排、提示词）。roster/ 拥有69个代理角色，每个角色一个文件，描述了该角色的职责、非职责范围、事实来源、审批需求以及可直接粘贴的描述。playbooks/ 包含九个角色研讨会（工程、产品经理、创始人、销售工程、销售、SDR、支持、售后、市场营销），涵盖了机器人团队、工作流、提示词和数据。ports/ 将名册转换为 Cursor 特定的规则文件。
• 指南和参考资料。 guide/ 包含两份 PDF：24页的 Grok Bot Guide by SpaceX Engineers（讲述了这三天的时间线、思维模型、故障日志、经济效益）和14页的 Grok Bot Marketing Guide（跨六个机器人的营销活动、发布日增长、分发）。reference/ 有两个简短文件——ECONOMICS.md（每一项成本和指标，以及支持它的规则）和 PRODUCT.md（哪些 Grok Bot 功能会影响机器人设计）。notes/ 包含支持每一项主张的结构化每日笔记。
• 工作流助手。 .github/ 包含一个拉取请求模板，将验证循环转化为一个表单：已复现、已附带证明、范围、需要人工介入。README 明确列出“迁移、部署、资金和权限”为无论代理循环运行得多么好，都应保留人工把关的操作。

核心理念。 README 的一段总结概括了操作原则：给每个代理分配一个狭窄的工作和一个名字。在构建第二个代理之前，先构建一个验证循环。让代理在修复 Bug 之前先复现它，并为所有内容附上证明。当代理出错时，写下通用原则，而不是具体故事。每周审计例行程序，因为“频率决定了资金流向”。对危险操作保留人工把关。

许可和使用。 MIT 协议——您可以将此仓库中的任何内容复制到您自己的项目中。

显著差距（README 未声称的内容）。 该仓库未描述如何使用 xAI Grok Bot 平台本身，不包含产品的源代码，未声称除72小时构建之外的任何性能基准，也没有记录除许可之外的当前维护状态或贡献者指南。