他让AI写代码前先签"结构合同"，错误率降了

你让AI写个API，它给你90%能跑的代码。但剩下的10%藏在最要命的地方——测试数据混进生产逻辑，错误处理丢上下文，层与层之间偷偷串门。这位开发者说：问题不在提示词，在AI根本不懂你的项目长什么样。

场景：一个反复出现的噩梦

想象这个画面。你打开Claude Code，输入："给我写一个用户管理API"。三分钟后，代码出来了，目录整齐，函数命名规范，甚至带了单元测试。你心头一喜。

直到编译运行。持久化逻辑大剌剌躺在领域层里。测试用的是mock数据，却忘了隔离真实数据库连接。错误抛出时，堆栈信息在某个抽象层断掉，你盯着屏幕找了三小时才定位。

作者把这叫"90%正确，10%在承重墙位置出错"。更糟的是，这10%不会报错——它安静地运行，直到生产环境炸掉。

根源很直白：大语言模型生成代码时，没有结构上下文。它不知道你的项目哪块砖该砌在哪堵墙上。

解法：一份YAML格式的"结构合同"

作者提出的工具叫Archetype（原型）。不是框架，不是代码生成器，而是一份声明式合同——用YAML写成，告诉AI：我的项目长这样，你生成的每一行代码必须 fit 这个形状。

合同里列五件事：

• 顶层目录怎么排
• 组件边界在哪，什么能跨过去
• 组件之间怎么约定接口
• 生成后必须通过哪些验证门
• 一份"自我挑战"规范，让AI自己检查自己

作者放出一个真实例子，叫hexagonal-api.yaml，二十来行。核心就一句：领域层不准碰数据库，端口（接口定义）和适配器（具体实现）必须物理分离。

这听起来像六边形架构的老生常谈。但关键区别在于——以前靠人盯，现在让AI先签保证书。

全流程：AI怎么执行这份合同

第一步，读取。Claude Code通过MCP服务器加载archetype文件，解析结构约束。

第二步，生成。AI按合同产出代码目录，文件树里domain/、ports/、adapters/各就各位。

第三步，自我挑战。这是作者设计的核心机制。AI重新读一遍合同，给自己的输出打分。发现领域层里偷偷塞了SQL语句？触发违规，回炉重造。

作者展示了一个实例：self-challenge检测到持久化逻辑入侵领域层，标记失败，迭代修正。没有人工介入。

第四步，跑测试。pytest全绿通过。

整个流程的关键在于"自我挑战"——不是人检查AI，是让AI用同一套合同检查自己。这解决了单次生成（one-shot）的根本缺陷：没有反馈闭环。

边界：什么时候别用

作者列了三条诚实限制，没有包装成"未来可期"：

• 新项目比老项目更适合。现有代码库的既有结构可能和合同冲突，迁移成本未明。

• 合同必须匹配你的技术栈形状，不只是语言。你用Django还是FastAPI，合同要对应。

• 频繁变动的接口会漂移。作者建议把archetype当"起步底盘"，不是永久规范——它解决的是生成时的结构一致性，不是运行期的接口演化。

这三条划清了工具的能力半径。不夸大，是技术写作者少见的克制。

商业设计：61份合同，开发者定价

作者建了一个市场（marketplace），目前已有5-6种archetype，覆盖不同场景。任何人都能发布，自己定价，甚至可以提供"卖家出资的返现"。

文档公开在/docs/archetype-schema，schema定义透明。

关于收费，作者写了一段罕见的坦诚说明：需要支付基础设施成本，自己投入了时间，定价故意压低。这不是"知识付费"的话术，是独立开发者算过账后的直白。

发布周有促销：61份他亲自写的archetype，用码SURPRISE_DEVTO返现约50%，限250次，6月18日截止。返现从他自己的版税里出，不是平台补贴。

最后一句暴露真实意图："反馈哪些archetype缺失，才是我真正想要的货币。"

为什么这件事值得技术人关注

这不是又一个AI编程工具。它触及的是一个被忽视的问题：代码生成的质量瓶颈，已经从"能不能写对语法"转向"能不能守对架构"。

提示工程（prompt engineering）的边际效益在递减。你再怎么优化"write me an API"的措辞，AI还是不知道你的领域层在哪。archetype的思路是把结构知识外化成可机器执行的合同，让AI在生成前先有"项目地图"。

更深一层：自我挑战机制暗示了一种新的代码生成范式——生成-验证-迭代的闭环内嵌在单次调用中。这和传统TDD（测试驱动开发）的区别在于，验证规则也是声明式的、可版本管理的、可复用的。

对25-40岁的技术从业者，这个工具的价值不在省几分钟写代码，而在降低"架构腐化"的隐性成本。那种90%正确、10%埋雷的代码，最耗人的不是写，是事后debug。

如果你正在用Claude Code或类似工具，且项目有明确的架构约束，值得去翻一下那61份archetype。6月18日前的返现是小事，看看有没有匹配你技术栈的"合同"，测一测自我挑战能不能拦住你踩过的那些坑——这才是作者真正想收集的反馈。