用途:为当前 Codex 工作创建持久、不可变的交接笔记,适用于用户要求检查点、收尾、交接、记住工作状态,或压缩后 SessionStart 上下文请求有意交接时。
主要能力:读取 ~/.codex/basic-memory.json 及最近项目的 .codex/basic-memory.json(项目键覆盖用户键),收集仓库证据(目标、最新意图、方法、当前状态、权衡、git 状态、分支、SHA、PR 信息、变更文件、测试结果、决策、阻塞、下一步等),并按 bm-writing 技能撰写笔记。每次调用都创建新检查点,绝不编辑或追加旧检查点。标题格式为 Codex checkpoint - <UTC YYYY-MM-DDTHH-MM-SSZ> - <short topic>。
使用方式:调用 write_note,project 设为配置的 primaryProject,overwrite=False,output_format="json"。general 配置写入 type: codex_session;coding 配置写入 type: coding_session 并包含 repository、repo_root、cwd、branch、git_sha 等必填字段。当有 session_id 时,搜索同聊天历史检查点并添加 continues 关系。正文以 # <exact note title> 开头,包含 Summary、Story、Working State、Changed Files、Verification、References、Observations、Relations 等章节。
确认回复:一句话总结、从成功 JSON 结果中选择的精确恢复标识符、一个主要下一步,以及最终代码块 $bm-orient "<exact returned resume identifier>"。
限制:不得声称未运行的测试通过;不得从对话文本推断仓库或 PR 身份;coding 必填字段无法证明时停止;不得复制大型计划、差异、日志或源文件;不得将机器本地或脆弱状态呈现为持久项目状态;不得为未推送提交构造 GitHub 链接。