Codex技术文章

做了几个产品之后，往往会遇到一个问题：代码仓库、演示地址、截图和介绍散落在不同地方，别人很难快速理解你做过什么，也不知道应该先体验哪一个。

一个个人产品集网站，可以把这些内容组织成一条清楚的访问路径：先认识你，再浏览产品，最后进入案例、打开演示或者联系合作。

这篇教程用 Codex + Cargo.site 完成这条路径。Codex 帮我们整理材料、制定设计方案、编写局部样式和检查页面；Cargo 负责可视化编辑、页面组织和发布。我们会围绕同一个案例，逐步给出提示词、示例输出、Cargo 操作和验收方法。

让 AI 帮忙修改 Go 项目时，代码能编译只是第一步。业务逻辑可能被放进 handler，请求的 context 可能在数据库调用前丢失，一个看似简单的 goroutine 也可能缺少退出路径。

这些问题往往与项目约定有关：分层如何协作，错误怎样转换，事务由谁管理，测试能否访问外部服务。如果每次任务都重新解释，既容易遗漏，也难以保持一致。

这些约定如果只留在聊天里，换一个任务就可能需要重新说明。把它们整理成项目里的 AGENTS.md，能让支持这一机制的编码助手获得持续可用的工作指引。

本文以 Go + PostgreSQL 的订单服务为贯穿示例，介绍如何把工程约定写进 AGENTS.md，并给出一份可按仓库调整的完整模板。文中的分层、路径和测试组织均为示例，需要结合项目实际取舍。