与 AI 智能体协作

TandemLoop 从一开始就是为外部 AI 智能体而设计的：它们作为平等的伙伴，与你在同一套数据上工作。App 本身不包含 AI——你可以连接自己选择的智能体式 AI 工具（参见连接 AI 工具）。数据文件夹中没有黑盒格式，只有任何工具都能读取的纯文本 Markdown。尽管如此，仍有一份明确的工作约定：你的结构如何变化，由你决定。

人机搭档原则

“双人自行车”这个比喻很好地描述了这种协作：你坐在前面掌握方向；智能体坐在后面提供动力。任何一方都不会擅自行动。对 App 来说，这意味着：

• 你确定愿景、优先级、关系和决策。
• AI 工具负责掌握全局、做好准备、发出提醒、识别规律并建议操作。

智能体如何使用数据文件夹

AI 智能体像其他任何工具一样读取数据文件夹——浏览文件夹结构，读取 YAML Frontmatter 和 Markdown 正文。它们可以写入什么，取决于你是否启用了提案：

已有标签由你自己在 App 中重新命名或删除。无论设置如何，智能体都可以创建自定属性和主题，并可按你的要求为任何未完成的任务设置提醒。无论哪种情况，都禁止直接编辑 _archive/、_system/、_conflicts/、_config/ 中的 App 设置以及 AGENTS.md 中的托管区块。

每次运行时，智能体都会把时间记录在 _config/agent.yaml（last_run）中。TandemLoop 据此在智能体交回 › 待智能体处理中显示它上次工作的时间——参阅自主、持续地协作。

开启或关闭提案

提案是可选功能，默认关闭。你可以随时在设置中启用：

此设置适用于整个数据文件夹。关闭时，TandemLoop 会隐藏所有提案区域；已有的提案文件保持不变，重新开启提案后会再次显示。

提案——由你批准的更改

启用提案后：提案是 _proposals/ 文件夹中的一个 Markdown 文件。它描述一个或多个操作（例如“将任务 X 移到项目 Y”），并附上理由。你可以整体或逐项批准、拒绝提案，或者退回要求修改。

有关提案工作流程的更多内容，请参阅本手册第 4 部分。

自定属性——智能体也能创建

自定属性是智能体所了解的数据模型的一部分：AGENTS.md 和 _system/docs/data-model.md 列出了当前定义的所有属性，包括键名、类型、适用范围、选项和描述。每当你创建、更改或删除属性——或者智能体写入了新的定义文件——App 都会自动更新这份列表。

例如，智能体可以根据你的要求为任务创建一个“客户”属性，然后填写该属性——不使用提案时直接填写；使用提案时，在分配给它的条目和新创建的条目中直接填写，在其他所有条目中则通过提案填写（参数 attributes）。

AGENTS.md——给智能体的说明

数据文件夹的根目录中有一个 AGENTS.md 文件。它向每个 AI 智能体说明规则：允许的操作、写入规则、目录结构，以及——启用提案时——提案格式。App 会保持这个文件最新，并在开启或关闭提案时相应地重写它。你可以阅读它，但不应手动更改 TANDEMLOOP:START 与 TANDEMLOOP:END 标记之间由系统管理的区块。