Communitygithub.com

cotcodec 仓库工作规程

CoTCodec 研究项目、实验、证据、文档和发布规范的仓库级工作规程。

cotcodec 仓库工作规程 是什么?

CoTCodec 是一个研究程序和可执行的评估框架,旨在让智能体编排决策变得明确、可测量和可优化。该技能(SKILL)规定了在 cotcodec 仓库中工作的完整规程,包括如何处理研究假设、注册实验、管理证据、维护文档以及准备发布。它特别强调了不变的原则,例如预先注册实验、保留负面结果、分离确定性基础设施与真实模型验证、以及通过哈希绑定所有结果。支持的研究平台包括基于 CLI 的 AI 智能体(如 Claude Code、Codex CLI)以及可能的 Cursor 等 IDE。该技能依赖于一组关键文件:`memory.json`(项目和优先级状态)、`wiki/log.md`(不可变操作日志)、`directions/`(研究假设)、`experiments/`(预注册实验)以及 `harness/`(执行基准)。通过遵循此规程,开发者和智能体可以确保所有实验都是可审计、可复现的,并且项目状态始终与文档同步。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add Kevin-Liu-01/cotcodec

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

相关技能