shared-memory-intake

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Shared Memory Intake

共享内存收录

Use

~/.codex/memories/

as the canonical shared knowledge store and

~/.agents/shared-memory-inbox/

as the external submission store. Read

MEMORY.md

before opening matching

rollout_summaries/

files. Treat dynamic claims as

UNCONFIRMED

until verified in the active session.

将

~/.codex/memories/

作为标准共享知识存储库，将

~/.agents/shared-memory-inbox/

作为外部提交存储库。在打开匹配的

rollout_summaries/

文件前，请先阅读

MEMORY.md

。在当前会话中验证之前，动态声明均视为

UNCONFIRMED

（未确认）。

Actor contract

参与者约定

Require an explicit actor:

--as claude

--as codex

. Never infer it from the runtime.

Actor	Allowed operations	Forbidden operations
`claude`	read official memory; create one submission in `inbox/pending/`	edit or delete official memory, or another submission
`codex`	read, review, promote, supersede, maintain	delete historical summaries or silently overwrite a current claim

必须指定明确的参与者：

--as claude

或

--as codex

。绝不能从运行时推断参与者身份。

参与者	允许操作	禁止操作
`claude`	读取官方内存；在 `inbox/pending/` 中创建一份提交	编辑或删除官方内存，或修改其他提交内容
`codex`	读取、审核、升级、替代、维护	删除历史摘要或静默覆盖当前声明

Claude: submit

Claude：提交流程

Read
```
MEMORY.md
```
; do not restate an existing current claim as a new submission.

Create one uniquely named Markdown file under

~/.agents/shared-memory-inbox/pending/

with YAML frontmatter:

yaml

schema_version: 1
source_runtime: claude
submitted_at: 2026-07-26T00:00:00Z
cwd: /absolute/path
source_session: opaque-session-id
claim_status: unverified
evidence_host: hostname-or-fleet-id

evidence_host

is optional for same-host evidence and required when the cited source exists only on another host.

Keep only reusable conclusions, source references, evidence, and unknowns. Never include credentials, tokens, private keys, cookies, or raw transcripts.

Validate before handoff:

python3 ~/.agents/skills/shared-memory-intake/scripts/validate_submission.py /absolute/path/to/submission.md

A correction is a new submission with
```
supersedes_submission
```
; never overwrite the earlier proposal.

阅读
```
MEMORY.md
```
；请勿将现有当前声明作为新提交重复提交。

在

~/.agents/shared-memory-inbox/pending/

下创建一个唯一命名的Markdown文件，包含YAML前置内容：

yaml

schema_version: 1
source_runtime: claude
submitted_at: 2026-07-26T00:00:00Z
cwd: /absolute/path
source_session: opaque-session-id
claim_status: unverified
evidence_host: hostname-or-fleet-id

若证据来自同一主机，

evidence_host

为可选；若引用的源仅存在于其他主机，则

evidence_host

为必填项。

仅保留可复用的结论、源引用、证据和未知内容。绝不能包含凭证、令牌、私钥、Cookie或原始对话记录。

移交前进行验证：

python3 ~/.agents/skills/shared-memory-intake/scripts/validate_submission.py /absolute/path/to/submission.md

修正内容需作为新提交，并添加
```
supersedes_submission
```
字段；绝不能覆盖之前的提交内容。

Codex: review and promote

Codex：审核与升级流程

Acquire the single-curator lease before promotion:
```
mkdir ~/.agents/shared-memory-inbox/.curator.lock
```
. If it already exists, stop and report the active-curator conflict. Release it with
```
rmdir
```
after the outcome is recorded.
Run the validator on the candidate. Reject on schema or secret-pattern failure.
Inspect the cited source and live-verify every dynamic claim that would enter the current index. For cross-host evidence, require
```
evidence_host
```
, verify the live source on that host, and record the curator host plus verification time in the promoted summary. Missing host access remains
```
UNCONFIRMED
```
.
Re-read
```
MEMORY.md
```
immediately before its update. If its relevant topic changed during review, restart the review instead of merging assumptions.
Promote accepted knowledge to a new immutable
```
rollout_summaries/*.md
```
record and update
```
MEMORY.md
```
as the only current index. Give every changed reusable claim a lifecycle state:
```
active
```
,
```
superseded
```
, or
```
UNCONFIRMED
```
.
Move the candidate to
```
processed/
```
or
```
rejected/
```
without deleting its audit trail.

在升级前获取唯一管理员锁：
```
mkdir ~/.agents/shared-memory-inbox/.curator.lock
```
。如果锁已存在，请停止操作并报告管理员冲突。操作完成后，使用
```
rmdir
```
释放锁。
对候选提交运行验证器。若存在 schema 错误或包含敏感信息模式，则拒绝提交。
检查引用的源，并现场验证所有将进入当前索引的动态声明。对于跨主机证据，需要
```
evidence_host
```
，在该主机上验证源的有效性，并将管理员主机和验证时间记录到升级后的摘要中。若无法访问对应主机，则标记为
```
UNCONFIRMED
```
（未确认）。
在更新
```
MEMORY.md
```
前立即重新读取。若审核期间相关主题发生变化，请重启审核流程，而非基于假设合并内容。
将通过审核的知识升级为新的不可变
```
rollout_summaries/*.md
```
记录，并更新
```
MEMORY.md
```
作为唯一当前索引。为每个变更后的可复用声明设置生命周期状态：
```
active
```
（活跃）、
```
superseded
```
（已替代）或
```
UNCONFIRMED
```
（未确认）。
将候选提交移至
```
processed/
```
（已处理）或
```
rejected/
```
（已拒绝）目录，不得删除其审计轨迹。

Codex: maintain

Codex：维护流程

Acquire the same single-curator lease and re-read
```
MEMORY.md
```
immediately before every official-memory write; stop on an active-curator conflict.
Scan current index entries for changed paths, versions, models, deployments, or stale references.
Demote unverified dynamic claims to
```
UNCONFIRMED
```
; mark replaced claims
```
superseded
```
with their replacement reference.
Consolidate duplicate current entries. Do not rewrite historical rollout summaries.
Re-run the validator on any newly promoted submission and report the paths changed.

在每次写入官方内存前，获取相同的唯一管理员锁并立即重新读取
```
MEMORY.md
```
；若存在管理员冲突则停止操作。
扫描当前索引条目，检查是否存在路径变更、版本更新、模型调整、部署变动或过期引用。
将未验证的动态声明降级为
```
UNCONFIRMED
```
（未确认）；标记已被替换的声明为
```
superseded
```
（已替代）并添加替代引用。
合并重复的当前条目。不得重写历史升级摘要。
对任何新升级的提交重新运行验证器，并报告变更的路径。

Validator

验证器

Use

scripts/validate_submission.py

. It is a narrow preflight gate, not proof that a claim is true and not a complete secret scanner. A pass authorizes review only; Codex still owns evidence verification and promotion.

使用

scripts/validate_submission.py

。它是一个狭义的预检工具，并非声明真实性的证明，也不是完整的敏感信息扫描器。验证通过仅代表可进入审核阶段；Codex仍负责证据验证和升级操作。