本仓库用于学习、拆解、复现和比较各类 coding agent。
docs/：架构理解、拆解记录、对比分析reproductions/：各个 agent 的复现代码与实验目录notes/：学习日志、阶段结论、问题记录assets/：截图、流程图等静态资源
新增复现项目时，统一放在 reproductions/<agent-name>/ 下，并尽量把代码、说明、测试放在同一个子目录内。
当前仓库没有统一的全局构建命令，优先使用各子项目自己的命令，并在对应目录的 README.md 中写清楚。
常用检查命令：
git status
rg "keyword" .
find reproductions -maxdepth 2 -type f | sort示例：
cd reproductions/opencode
python -m pytest
node --test- 文件编码：
UTF-8 - 行尾：
LF - Markdown：标题清晰，内容简短直接
- Python：4 空格缩进，函数/文件用
snake_case，类名用PascalCase - JS/TS：遵循子项目现有风格，变量和函数用
camelCase
如果某个复现目录已有自己的风格或格式化配置，以该目录为准。
有可运行代码时，尽量补测试，并放在对应复现目录附近，例如 reproductions/<agent>/tests/。
- Python：
test_*.py - JS/TS：
*.test.js、*.test.ts
每个可运行的复现目录，至少提供一个可执行的测试或验证命令。
提交信息尽量简短，建议使用：
feat: ...fix: ...docs: ...chore: ...
分支命名统一使用 xx/xxx 格式，推荐使用职责前缀 + 简短主题，例如：
docs/update-readmefeat/agent-loopfix/context-builder
PR 说明至少包含：
- 改动目的
- 影响目录
- 运行或测试说明
涉及界面或流程变化时，再附截图。
- 不要提交密钥、Token、
.env或大体积生成文件 - 尽量保持每个复现项目依赖独立，避免相互污染
- 不要在同一个 PR 中混入无关实验改动
下面内容留给仓库维护者后续补充：
- 当前优先复现的 agent 列表
- 各实验目录的技术栈选择
- 通用脚手架或模板约定
- 个人偏好的提交、评审与记录方式
.agents/skills/study-coding-agents/：用于系统性研究 coding agent 的设计与实现，基于用户给定主题/链接补充检索，产出中文学习文档和最小实现 todo 清单。仅在本仓库内使用。