教程

标准化 Bob 的行为

使用项目级规则文件在团队中标准化 Bob 的行为,这些文件指示 Bob 记录其代码并记住其先前的操作。

Bob 规则是定义应用于每次 Bob 对话的指令的纯文本文件。Bob 将规则作为文件存储在项目内的指定文件夹中或全局用户级别,并自动将每个规则文件的内容注入到所有模式的每次对话中。规则注入允许团队和个人开发者执行编码标准、通信偏好和工作流约束,而无需在每个提示中重复指令。

galaxium-travels/.bob 中的项目级规则与您的代码一起进行版本控制,这意味着:

  • 规则会自动传播到克隆存储库的所有团队成员。
  • 对规则的更改会经过正常的代码审查流程。
  • 规则历史记录在 git 中跟踪。

在本教程中,您通过在 .bob 目录中添加规则文件来指示 Bob 简洁地说话、记录其代码并记住其先前的操作。由于您将这些文件包含在版本控制中,Bob 将在整个团队中应用它们。

先决条件

要完成本教程,您需要以下内容:

  • 如果您还没有,请克隆 Galaxium Travels 演示代码。克隆命令还会检出包含您在教程中使用的代码的 bob-learning-path-branch 分支。
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • 打开 Galaxium Travels 演示代码的 Bob IDE
  • 完成启动项目教程以创建 .bob 文件夹。
  • 虽然不是必需的,但请考虑完成快速入门教程以熟悉 Bob 的界面和功能。
  • Python 或 Python 3。您可以从官方网站下载 Python。

创建自定义 Bob 规则文件

Bob 的 /init 命令会创建一个 .bob 文件夹,其中包含每个 Bob 模式的 AGENTS.md 文件,这些文件指导 Bob 在每个模式中的行为。通过向 rules 文件夹添加新文件来创建您自己的自定义规则。Bob 将读取规则文件的内容,这意味着您添加的指令将应用于与 Bob 的所有交互。

创建规则文件夹

如果 .bob 中还不存在 rules 文件夹,请创建一个。

创建规则文件

galaxium-travels/.bob/rules/ 中创建一个名为 basic_rules.md 的文件。

在项目中创建的 .bob/rules/basic_rules.md 文件

创建自定义 Bob 规则

basic_rules.md 文件中,通过添加以下文本来创建自定义规则:

添加文档标准规则

Always include concise JSDoc strings for every public function.

文档标准规则确保 Bob 在编写或修改公共函数时生成一致的文档,无论任务如何。

添加通信风格规则

Be very concise in your wording.

通信风格规则控制 Bob 如何表述响应和注释,这对于喜欢简洁、直接输出而不是详细解释的团队很有用。

添加内部独白规则

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

内部独白会生成 Bob 在所有对话中所做的所有事情的持久日志。

内部独白的好处包括以下内容:

  • 审计跟踪:记录 Bob 进行了哪些更改以及何时进行的。
  • 跨会话连续性:Bob 可以在未来的对话中引用内部独白文件夹以了解先前的工作。
  • 团队透明度:在共享存储库中,独白显示不同团队成员使用 Bob 做了什么。

添加所有规则后,您的 basic_rules.md 文件将如下所示:

添加了所有三个自定义规则的 basic_rules.md 文件

测试规则

打开代理聊天侧边栏,切换到代码模式,并运行以下提示让 Bob 编辑 README.md。Bob 可能会提出建议,例如通过更好的故障排除进行增强、完全改造或修复不准确之处。您可以选择最适合您对 README 的愿景的建议。

Update the readme

Bob 更新 README.md 并创建一个名为 internal-monologue 的文件夹,并创建一个文件,向您显示它对 README 所做的更新。

Bob 更新 README.md 并创建内部独白文件

后续步骤

在本教程中,您了解了 Bob 规则如何让您定义应用于每次对话和模式的持久指令。项目级规则与您的代码一起进行版本控制,因此您的团队会自动共享相同的标准。内部独白模式为您提供了 Bob 在所有会话中的操作的审计跟踪。

继续学习添加 Bob 功能,了解如何创建自定义模式,这些模式定义具有定制指令和特定工具访问权限的专业角色。

这个主题怎么样?