用途:Ergon 用于跨智能体会话维护一个持久、依赖感知的工作图,支持跟踪任务前置关系、查找就绪与阻塞任务。仅在显式调用或请求确需维护/查询持久任务图时使用;不要强行把普通编码变成记账,不隐式迁移已有任务,也不改变 $plan/$actuating 路由。只作用于调用方指定的仓库。
主要能力:任务具有仓库本地稳定标识、不可变标题和 open/closed 生命周期。依赖 B requires A 表示 A 关闭时 B 才合格;多个前置为合取,须全部关闭。就绪状态是派生的:open 任务的所有直接前置均非 open 时即就绪。关闭或重开 A 会改变依赖它的 open 任务的就绪状态,但不写入这些任务;关闭不会自动重开下游。依赖两端必须存在,缺失端点、自依赖与环会被原子拒绝。删除边保留历史并解除阻塞;重新添加恢复同一关系标识。
使用方式:先加载当前 $ledger 技能并完成 ensure 流程,要求 Ledger 1.2.0 或更高(主版本 1,含 reducer v6、fold v7);不要静默退回 1.1。检查定义:ergon_definition="$(realpath "${CODEX_HOME:-$HOME/.codex}/skills/ergon/definitions/ledger/task-protocol.json")";ledger definition check --definition "$ergon_definition" --format json。权威存储为所选仓库下 .ledger/ergon/events.jsonl,只能用原生事务修改,通过投影或 doctor 读取,禁止手改存储或另行计算权威图。写请求 JSON 到 .ledger 外的临时文件,由 Ledger 构造事件与关系标识。create/close/reopen 用 submission 绑定,add-dependency/remove-dependency 用 dependency 绑定。除创建外,每次变更先观察当前投影并提供精确 store.revision。示例:ledger transact --definition "$ergon_definition" --operation create --repo "<repo-root>" --input submission="<task.json>" --param request="<request-id>" --format json;ledger project --definition "$ergon_definition" --projection ready --repo "<repo-root>" --format json。若结果不确定,保留原操作与请求字节重试。
适用场景:需要跨会话记录任务前置关系、判断哪些任务可开始、哪些被精确阻塞,以及查看当前、open、ready、blockers、dependencies、history 等确定性投影。
限制:初始上限为 128 个任务、1024 个依赖标识、16384 个事件、16 MiB 存储/输出、4 KiB 输入、128 字节 ID、512 字节标题,超限失败关闭,无压缩或隐式保留。支持多进程共用一个本地权威存储,不支持断连副本或 Git 冲突解决。bind-existing 仅用于完全校验过的当前格式存储,不是导入/迁移/修复捷径。关闭仅记录授权领域决定,不证明实现正确;就绪不预留任务,也不授权执行。未提供的信息暂未提供。