cotcodec —— 在此工作
目的
CoTCodec 是一个研究程序和一个可执行的评估框架,旨在让智能体编排决策变得明确、可测量和可优化。论文 1 研究语言;共享框架和证据记录涵盖了更广泛的编排变量程序。
心智模型与关键文件
memory.json是编译后的项目状态和活动优先级账本。wiki/log.md是仅追加的操作时间线。directions/拥有研究假设;experiments/拥有预注册的运行。harness/执行条件和基准;scripts/验证和封存。research/evidence/包含可移植的决策包。原始/本地暂存文件属于被忽略的data/,永远不会意外进入 Git。README.md是人类入口点;AGENTS.md是完整的操作参考;目录下的SKILL.md文件拥有本地规程。
要遵循的模式 / 不变原则
- 在实质性工作之前,读取
wiki/SOUL.md、wiki/USER.md、wiki/HEARTBEAT.md和memory.json。 - 在观察处理结果之前,预先注册伪造者、预算、声明边界和停止条件。永远不要重写已完成实验的合约。
- 保留负面证据和结果前证据。创建带版本的重跑,而不是覆盖失败的输出目录。
- 将确定性基础设施准入与实时模型或科学声明分离。CPU 符合性绝不意味着 H100 准入或记忆质量。
- 对于任何用于研究决策的结果,绑定源代码修订版、树、许可证、依赖项、镜像/模型身份和执行哈希。
- 保持
memory.json编译真理和wiki/log.md时间线同步。
常见任务 → 第一步操作
| 任务 | 第一步操作 |
|---|---|
| 继续研究 | 读取 memory.json 优先级和最新的 wiki/log.md 条目。 |
| 运行实验 | 读取 skills/run-experiment.md,然后读取其 YAML 合约。 |
| 添加基准 | 读取 harness/benchmarks/SKILL.md 和基础适配器。 |
| 更改编排逻辑 | 读取最近的 harness/**/SKILL.md 和配对测试。 |
| 添加记忆系统 | 读取 infra/memory-baselines/SKILL.md 以及组合/源验证器。 |
| 提交证据 | 运行路由工件的源、实验、证据和组合验证器。 |
| 更新文档 | 刷新 Agent-Docs、README/当前状态页面、memory.json 和 wiki/log.md。 |
注意事项
- 许多基准适配器是有意为之的存根;存在不等于就绪。
data/可能包含数 GB 的模型、数据库、源代码树和 Docker 工件。在暂存前检查被忽略/未跟踪的文件。- 精确源码生命周期作业通常使用 GPU 主机上的 CPU 分配。包含
h100的主机名并不证明请求或使用了 GPU。 - 历史路径
~/Documents/GitHub/kevin-wiki可能在本地不存在;在需要时设置KEVIN_WIKI_ROOT以用于scripts/run-agent-docs.ts。