用途
Ledger 为所有者定义的工件协议提供共享的引导、存储上下文策略和操作准则。它适用于显式 $ledger/$ledger ensure、使用方的首个原生命令、运行时/ABI 可用性、托管存储上下文、工作树连续性、定义编写、校验/物化、持久事务/投影、绑定、遗留迁移以及精确恢复等场景。
主要能力
基准原生接口包括:ledger definition check、ledger definition describe、ledger validate、ledger materialize、ledger transact、ledger project、ledger doctor、ledger recovery inspect、ledger recovery reclaim、ledger capabilities、ledger version。
结果语义:definition check 验证闭包的 ABI/操作符;definition describe 暴露编译表面而非语义批准;validate 校验显式输入;materialize 推导规范表示和身份;transact 执行选定的声明效果并返回保管回执;project 读取/重放选定的声明存储并输出精确投影;doctor 验证绑定、完整性、重放和相对定义的健康状况;recovery inspect 见证一笔精确事务;recovery reclaim 仅在所有见证检查后执行授权的绑定事务回收。
使用方式
在首个原生 Ledger 命令之前,需完成一次 $ledger ensure。当解析的可执行文件和执行环境未更改时复用就绪状态;任一更改时重新检查。$ledger 是技能语法,不是 shell 命令。
引导命令:
ledger_skill_root="$(realpath "${CODEX_HOME:-$HOME/.codex}/skills/ledger")"
"$ledger_skill_root/scripts/ensure-ledger"
在 ledger-bootstrap-ready/v1 之后,直接调用原生 CLI。处理程序要求 Ledger 1.3.0 或更新(主版本 1 内)以及 ledger-artifact-abi/v1。仅在用户级配置获得授权时,才可安装或升级 tkersey/tap/ledger。否则按其补救说明停止。切勿使用替代实现、curl | sh、未固定版本的下载或在活动仓库效果期间安装。它不代理命令。
选择操作前,根据语义所有者的请求进行选择。纯校验、物化或定义检查仅使用此入口点和所有者的精确定义/输入,不涉及工作区、托管存储或迁移扫描。规范存储读/写、doctor、投影、事务或托管上下文解析需在上下文选择或首个操作前阅读 canonical-custody.md。绑定、遗留迁移或精确恢复需在效果前阅读规范保管指南及其选定的维护/迁移参考。编写或调试被动定义需阅读 definition-authoring.md。
适用场景与限制
被动定义位于语义所有者旁,列于其 definitions/manifest.json 中,为 JSON 格式,非钩子、命令、可执行文件、网络调用或隐藏发现过程。所有者声明逻辑槽位,不能选择绝对输出路径或逃逸选定的控制根。除非需要持久身份/历史,否则优先使用纯校验/物化。
本技能单独拥有物理存储位置和迁移策略。需在解析或操作规范保管前阅读 canonical-custody.md,不要在使用方或 AGENTS.md 中重复其策略,也不要用空存储替代失败的查找。首次使用资格认证即使对现有注册也需遵循。纯校验/物化不选择此工作流。
报告时需说明实际操作、选定的定义/闭包/ABI、结果模式和判定、存储变更、相关时精确寻址的来源/事务以及剩余所有者操作。缺失元数据会限制主张。保持纯校验、事务、doctor、上下文失败和恢复结果彼此独立,而非强制归入一个通用状态模板。
关于具体的收费、价格、平台支持范围及详细使用步骤,当前资料暂未提供。