用途:agent-protocol 是一份在每次会话开始时、以及上下文压缩之后需要阅读的行为约定,用于让智能体理解组织要求与预期的行为方式。它本身不是可安装的工具,资料未提供安装命令或代码。
主要约定:任务工作应在 worktree 中进行,根检出(root checkout)只用于定位和快进同步。对于非平凡任务,需使用 /session-worklog 维护 worklog,记录可执行的智能信息而非日常活动。临时操作材料放在 ephemeral/ 下,未经明确许可不得写入 docs/。每个任务后追加 worklog 并做检查点提交;不要仅因提交而重跑检查。在声明 PR 可合并前,先完成相关的证明与正确性协议。PR 采用 squash-merge,PR 正文需能直接作为 squash 提交信息,扩展说明和评审讨论放在 PR 评论中。合并后删除任务 worktree 并停止其后台进程。无论来源如何,都要修复损坏的测试或 CI;若既有失败会明显干扰任务,需询问 HITL 是否继续。开始工作前和 PR 合并后都要对根检出做快进。ephemeral/ 是受跟踪的工作材料,如 worklog、计划和下载的产物;仅当用户启动或命名项目时才创建 ephemeral/projects/<project-slug>/,并遵循目标仓库记录的项目列表。
适用场景:作为团队内智能体协作的流程规范,约束会话阅读、任务隔离、日志、提交、PR 合并与清理。限制:资料未说明具体实现形式、支持平台或执行工具;内容以流程约定为主,未提供代码示例或安装方式。