Communitygithub.com

Kevin-Liu-01/cotcodec

CoTCodec研究プロジェクト全体のための手続きガイド:実験、証拠管理、ドキュメント、リリース衛生を一元化。

cotcodec とは?

CoTCodecは、AIエージェントのオーケストレーション選択を明示的かつ計測可能、最適化可能にするための研究プログラム兼実行可能評価ハーネスです。このスキル(SKILL.md)は、プロジェクト全体の作業手順を定義し、エージェントが研究を継続する際の最初のアクション、重要なファイルの役割(memory.json、wiki/log.mdなど)、実験の事前登録や証拠のバージョン管理といった不変条件を提供します。主にClaude CodeやClineなどのファイルベースのエージェント向けに設計されており、リポジトリ内のSKILL.mdファイル群を参照することで、エージェントが自己整合的にタスクを実行できます。また、負の結果を含むすべての証拠を保持し、決定論的なインフラ検証と科学的クレームを分離するなど、研究の再現性と透明性を重視した運用ルールを定めています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add Kevin-Liu-01/cotcodec

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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での受け入れやメモリ品質を意味しません。
  • 研究上の判断に使用される結果については、ソースリビジョン、ツリー、ライセンス、依存関係、イメージ/モデルID、実行ハッシュを必ずバインドしてください。
  • 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/current-stateページ、memory.json、wiki/log.md を更新する。

注意点

  • 多くのベンチマークアダプターは意図的にスタブです。存在が即座に利用可能であることを意味しません。
  • data/ には数ギガバイトのモデル、データベース、ソースツリー、Dockerアーティファクトが含まれる可能性があります。ステージング前に無視/未追跡ファイルを検査してください。
  • 正確なソースのライフサイクルジョブは、GPUホスト上でCPU割り当てを使用することがよくあります。ホスト名に h100 が含まれていても、GPUが要求または使用されたことは証明されません。
  • 過去の ~/Documents/GitHub/kevin-wiki パスがローカルに存在しない場合があります。scripts/run-agent-docs.ts を使用する際は KEVIN_WIKI_ROOT を設定してください。

関連スキル