MASE 班次协议标准件：open（开班）/ relay（交班）/ night-mode（夜班）— Shift protocols for AI coding agents: session resume, close & handoff, bounded autonomous overnight work. AtomCode skills, MIT.
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 15 天前 | ||
| 16 天前 | ||
| 16 天前 | ||
| 17 天前 | ||
| 16 天前 | ||
| 17 天前 |
MASE Shift Protocols — AI Agent 会话三协议 / Shift Protocols for AI Coding Agents
📮 已在 AtomCode 官方仓库提建议收编：https://atomgit.com/atomgit_atomcode/atomcode/issues/1571
MASE 的"班次器官"：MASE（Minimal Agent Skeleton Engine）的 skeleton 本体不管状态——agent shell + 云端模型架构下的会话间状态交接（open/relay）与夜间自主工作（night-mode），全靠这三个 skill 执行。 三个可复用的 Agent 触发词协议：open（开班/续班）、relay（交班/收班交接）、night-mode（夜班/夜间自主工作）。 适配 AtomCode 的 skill 标准件格式（
skills/<name>/SKILL.md），也适用于任何支持 skill/instruction 文件的 AI 编码代理（Claude Code、Codex 等，格式微调即可）。
EN: The shift organs of MASE (Minimal Agent Skeleton Engine): the skeleton itself holds no state — in an agent-shell + cloud-model architecture, cross-session state handoff (open/relay) and autonomous overnight work (night-mode) are executed entirely by these three skills.
Three reusable trigger-word protocols for AI coding agents — open (start/resume a shift), relay (close & hand off a shift), night-mode (bounded autonomous overnight work). Packaged in AtomCode skill format (skills/<name>/SKILL.md), with a portability guide for other shells (Claude Code / Codex / Cursor — see below).
解决什么问题 / The problem it solves
AI 编码代理的会话是易失的：上下文一断，"项目进行到哪、接下来干什么、哪些坑别再踩"全部蒸发。用户每次都要重新解释背景，或者 Agent 凭残缺记忆瞎猜（我们实测出现过：把"夜间工作模式"误判成"给网站加暗色主题"并部署上线）。
本仓库用三个协议把"状态"变成磁盘上的文件，把"触发动作"变成可移植的标准件——三者构成一个完整的班次闭环（一天 = 开班 → 夜班 → 交班 → 次日开班）：
- 状态 =
STATUS.md（六节快照，唯一交接入口）+FACTS.yaml（只增不改的原子事实） - 动作 = 三个 skill，用户只需说一个词
EN: AI coding sessions are volatile — once context is gone, so is "where we are, what's next, which pitfalls to avoid". These protocols turn state into files on disk and actions into portable standard skills, forming a complete shift loop (a day = open → night → relay → next open). One word from the user is enough.
三协议一览 / The three protocols
| 触发词 | 干什么 | 核心动作 |
|---|---|---|
| open | 开班/续班 | 读 STATUS → 读 FACTS 尾部 → 跑探针自检 → ≤5 行汇报 → 直接开工 |
| relay | 交班/收班交接 | FACTS 入账（只增不改）→ 探针回归 → 重写 STATUS 六节快照 → ≤10 行收班摘要 |
| night-mode | 夜班/夜间自主工作 | 以 RSI（自进化）为内核，在一个算力窗口内自主干活：探索未完之事 / 信息碰撞 / 自我审计 + 晨报 ≤15 行 |
闭环：open 交接给一天的工作，night-mode 在夜间延伸同一天，relay 在日落时把状态落盘交给次日 open——状态永远在磁盘上流转，人的记忆不参与接力。 Loop: open starts the day, night-mode extends it overnight, relay persists state at dusk for tomorrow's open.
night-mode 为什么存在：Agent 平台的算力常按窗口计量（例如配额每 5 小时刷新一次），窗口不用就是浪费。night-mode 的价值就是把这个窗口榨干——进入自由探索 + 完善修正的自主状态，而不是白天那种被具体任务牵着走的状态。 Why night-mode exists: agent platforms usually meter compute in windows (e.g. a quota refreshing every 5 hours); an unused window is capacity thrown away. night-mode spends the whole window in a self-directed state — free exploration and refinement, not task-driven daytime mode.
MASE alignment（这些 skill 在 MASE 里的位置 / where these skills sit in MASE）
These skills provide a portable, runtime-agnostic behavior governance layer (MASE), independent of the underlying Agent Shell and LLM. They can be transplanted to Claude Code, OpenClaw, or DeepSeek Harness.
MASE（Minimal Agent Skeleton Engine） 的最小骨架只有六样东西：一个锚点（项目是什么）、一份状态（现在在哪）、一份事实（已经确认了什么）、一条轨迹（做过什么）、一个探针（怎么自查）、一份协议（怎么做）。本仓库的三条协议就是那个"协议"器官中管班次的部分——所以它们不绑定任何模型，也不绑定任何壳。
诚实说明依赖边界（避免过度声明）："runtime-agnostic" 不等于零前提，它只要求目标壳满足两个条件——① 有指令加载机制（能读一份 markdown 指令文件）；② 有文件读写能力（能落盘状态与事实）。满足这两条的壳都能跑；不满足的（纯对话、无文件系统的壳）跑不了。
已验证 / 计划中的移植目标：
| 壳 / Shell | 状态 |
|---|---|
| AtomCode | ✅ 原生（本仓库格式即其标准件） |
| Claude Code | ✅ 机制同构（.claude/skills/） |
| OpenClaw | 🟡 待验证（有指令+文件能力，预期可移植） |
| DeepSeek Harness (dsh) | 🟡 待验证（同上） |
| Codex / Cursor | 🟡 需改写挂载方式（无 skill 机制，走 AGENTS.md / rules） |
一句话：MASE 定义"一个 Agent 应该有什么器官"，本仓库交付其中"班次"这一器官的可移植实现。
安装 / Install
AtomCode
# 复制三个 skill 目录到全局 skills（无需管理员）
# Copy the three skill dirs into your global skills folder
cp -r skills/* ~/.atomcode/skills/
# 然后在 AtomCode 里执行 /reload
# Then run /reload inside AtomCode
之后新会话输入 / 应能看到 /skills:open、/skills:relay、/skills:night-mode。
其它代理 / Other agents
三个 SKILL.md 都是普通 markdown + YAML frontmatter。各壳的移植状态见上节 MASE alignment 表；怎么装：
- Claude Code：
cp -r skills/* .claude/skills/（机制同构），或在CLAUDE.md里引用 - Codex：无 skill 机制 → 把三份协议正文追加进项目
AGENTS.md - Cursor：写进
.cursor/rules或项目 rules 文件 - 其它 / generic：任何"读指令文件"的代理 → 把 SKILL.md 正文挂进它的系统提示或规则文件
关键：不管哪个壳，真正跨会话的是状态文件（STATUS/FACTS）——它跟壳无关。skill 只是把"怎么读怎么写"标准化。
项目侧需要什么 / What your project needs
最小要求只有一样：一个状态文件（STATUS.md，六节快照）。推荐再加 FACTS.yaml（原子事实）与自检脚本（探针）。三份模板在 templates/，复制到项目根改两行就能用；templates/AGENTS.md 是可选的项目级常驻指令（让 Agent 开会话自动读取）。
六节快照结构：
- 今日全量进展
- 新增事实记录
- 待用户拍板（按期限，每项四要素：是什么/细节/拍什么/建议）
- AI 下一步
- 环境坑（可复现的踩坑记录）
- 文件索引（文档内用 repo 相对路径；对用户汇报时才用绝对路径）
设计原则 / Design principles
- 状态在磁盘，不在对话 —— 没落盘的东西=丢了。
- 事实只增不改 —— 修正旧事实=追加新记录，保留决策轨迹。
- 单一事实源 —— 动态数字只从指定数据文件引用，杜绝多处手写漂移。
- 探针先行 —— 自检翻红先实证再下结论（探针也会误报）。
- 边界即协议 —— night-mode 的价值一半在"夜间禁做什么"。
- 对用户诚实 —— 汇报忠实于结果，包括失败与未验证项。
实战出处 / Battle-tested
本协议在 D:\黑客松.com 项目（全球 AI 黑客松情报平台）连续实战迭代一个月：日更数据管线（7 通道自动抓取/发布/部署/自检）、跨 20+ session 无缝交接、夜间自主跑管线修复与战略文档。night-mode 的消歧条款（"不是暗色主题"）来自一次真实的线上误部署事故。
License
MIT