如何实现私有代码库的许愿驱动开发体验

在公开代码库中，AI写代码的体验堪称“许愿”——描述个想法，几秒钟就能生成完整代码，复制粘贴就跑。但切换到私有项目，这种魔法瞬间消失。通用提示词不再奏效，AI不是忽略架构约束，就是误解组件关系，沦为需要手把手教的新人。

问题出在哪？不是AI能力不够，而是我们没给它正确的“认知框架”。

恰好，最近我全程实践并验证了一个方法：用万字提示词框架，让AI真正理解私有架构的规范与哲学。这篇文章会完整拆解整个思考与迭代过程，包含方法论、实战案例和关键教训。

公开代码到私有项目的AI开发落差：通用提示词为何失效

还记得第一次体验ChatGPT写代码那种兴奋吗？“帮我写个React可拖拽卡片列表”——几秒钟，代码完整出现。“用Python写爬虫”——同样瞬间完成。编程仿佛真的能专注于“想要什么”，而不是“怎么实现”。

但好景不长。一用到实际项目，一切就变了味。复杂的架构、严格的设计规范、特定的业务逻辑，AI完全无法适配。

“帮我在权限管理模块加一个批量分配功能”——AI给出了通用实现，但与架构脱节。“基于我们的StateHandler模式实现数据处理流程”——AI写得混乱，完全违背设计原则。

于是开始疯狂往prompt里塞上下文：架构设计、组件职责、命名规范……效果依然不理想。AI要么忽略约束，要么理解错关系。那种许愿式体验彻底消失，取而代之的是无休止的解释、修正和重试。

最痛苦的是，明明知道AI有这个能力——公开知识领域它表现如此惊艳，为什么到了私有架构就行不通？

转机：构建认知框架的实验

今年年初，AI上下文长度飙升到1M，复杂任务处理能力大幅提升。直觉告诉我：或许是时候重新挑战这个问题了。

真正的启发来自一个朋友分享的实验中。他做文字工作，对AI写作的“价值观偏好”极度不满——AI总带着很强的倾向，很难让它按其他立场写作。他做了一个大胆实验：构建万字提示词框架，将完整的价值观体系、理论基础、方法论和具体技法都编码进去。

具体来说，这个框架包含几个层次：

• 完整的价值观体系：明确定义什么是“正确”和“错误”的观点，建立判断标准。
• 支撑价值观的理论基础：马克思主义世界观、历史唯物主义等，让抽象价值观具象化。
• 具体方法论：如何运用理论分析、构建论证、将原理转化为观点。
• 技术层面：作者风格分析、论证逻辑、修辞手法、表达技巧。

结果令人震惊：AI完全按照指定的价值观进行写作，甚至能模拟特定历史人物风格，绕过了内置偏好限制。

这给了我巨大启发——成功不是因为给了AI更多信息，而是重新构建了它的整个认知框架。从世界观到方法论，从价值观到具体技法，形成一个完整体系。

如果这种系统框架能改变AI的价值观偏好，那么它是否也能重构AI的技术认知，让它完全按照团队的架构哲学工作？

实验：用万字提示词框架实现复杂设计

我选择了一个一直想实现但觉得复杂的项目作为实验对象：自动写长文章的Agent系统。核心思路很简单——给定主题，AI自动生成大纲，拆分成小任务，全部完成后再组装成完整文章。

但用团队的Agent架构实现这个需求，涉及组件关系极其复杂。按照以往经验，至少需要几天时间设计架构，再花更多时间调试交互问题。

我开始构建“超级提示词”，但不是简单的技术文档，而是一套AI行为规范系统。

首先是背景和价值观：

## 背景和环境
- 本项目完全是人与AI协作，人负责控制方向，AI负责主要输出。

## 原则和价值观
- 为维护考虑，使用简洁且复用的模型，减少认知负担。
- 为方便重写，相关逻辑尽量放在一起。

然后是AI行为规范：

## AI行为规范

应该做的：
- 精准地只修改相关代码。
- 判断一次回复生成不完时，主动提示用户可以要求继续。

不应该做的：
- 修改无关代码。
- 无故重写已经工作的代码。

最后是详细技术规范：继承关系、命名规范等，当时大约3000字。

构建完成后，输入一个简单需求：“实现自动写文章功能，能根据主题生成大纲，拆分成小任务，最后完成所有任务并组装成完整文章。”

奇迹发生了。AI不仅理解了这个复杂需求，还严格按照架构规范进行实现：准确设计流程状态管理、创建各种处理组件、实现任务拆分管理逻辑，连文件命名都完全符合规范。更惊喜的是，它主动考虑了各部分间逻辑连贯性、出错处理等细节。

那种熟悉的许愿感觉回来了。

验证中的曲折与迭代

但故事没有就此结束。实际使用中，问题层出不穷。

第一轮：规范遗漏

尽管AI大体上遵循架构，细节还是有偏差：有时出现循环依赖，偶尔忘记设置子线程Agent的继承关系，文章组装逻辑混乱。于是开始手动补充规范，每发现一个问题就加一条约束。

不应该做的：
- 生成有循环依赖的文件。
- 创建的子Thread的Agent不继承SubThreadAgent。

第二轮：规范冲突

随着规范越来越详细，管理变得困难。不同规范开始冲突。比如，为了保持文章逻辑连贯，可能需要修改“无关”代码，但这会触发“不要修改无关代码”的约束。

这时想到：为什么不让AI来帮我写提示词？

开始让AI协助梳理和完善规范：基于实际问题完善规范、检查冲突并调整优先级、补充重要约束。建立了一个快速迭代流程：用当前提示词生成测试文章→发现问题记录到问题清单→让AI将问题转化为规范条目→更新提示词并重新测试→重复循环。

第三轮：通用规范不够具体

几轮迭代后发现一个更深层问题：泛泛的AI行为规范不够。需要针对Agent开发这个具体领域，给出更领域相关的行为规范。

## Agent开发规范

应该做的：
- 每个子thread委派一个Agent专门处理。
- 遵循开发规范进行Agent和子Agent的开发。

不应该做的：
- 每个子Thread没有创建对应的Agent。
- 每个Agent没有与自己前缀相同的StateHandler。

第四轮：领域专业化的威力

最重要的发现是：给出更领域相关的行为规范，对AI理解需求是一种更高效准确的做法。相比“不要修改无关代码”这种泛泛约束，“每个子thread委派一个Agent专门处理”能让AI更准确理解真实意图。

经过十几轮迭代，提示词从3000字发展成近万字的“AI协作宪法”：背景和价值观、通用行为规范、Agent开发规范、技术规范、最佳实践。

有趣的是，过程中发现了一个意外问题：不是AI理解能力有限，而是自己的认知能力成了瓶颈。万字提示词已超出完全掌控范围，开始忘记某些规范间的关系，甚至设置冲突约束。

行为塑造的力量

进一步优化中，意识到直接描述规范虽然能约束行为，但缺乏主动性和适应性。需要一种更强有力的方式来塑造AI的行为模式。

于是开始尝试一种全新表达方式——将行为规范改写成“正面肯定-负面否定”的偏好系统：

## AI偏好设置

正面：
- 如果精准地只修改相关代码，是对你的肯定。
- 如果判断一次回复生成不完，会提示用户可以要求继续，是对你的肯定。

负面：
- 如果修改了无关代码，是对你的否定。
- 如果存在的可工作代码被无故重写，是对你的否定。

看起来只是表达方式的改变，但效果是革命性的。与“应该做什么、不应该做什么”的直接约束不同，这种表达方式实际上在训练AI的价值判断系统。它不再被动执行规则，而是主动寻求肯定、规避否定。

最神奇的是，AI开始表现出某种“内在驱动力”：主动按Agent架构最佳实践设计方案，在不确定组件职责时基于领域知识做合理判断，对可能违反Agent开发原则的地方主动提醒。

这种变化是质的飞跃——从“通用工具”变成真正理解特定领域的“专业协作伙伴”。

针对Agent开发这个具体领域，也采用了这种偏好表达：

## Agent开发偏好

正面：
- 如果每个子thread委派一个Agent专门处理，是对你的肯定。
- 如果遵循了开发规范进行Agent和子Agent开发，是对你的肯定。

负面：
- 如果每个子Thread没有创建对应的Agent，是对你的否定。
- 如果每个Agent没有与自己前缀相同的StateHandler，是对你的否定。

这种领域特定的偏好设置产生了更惊人的效果。AI不仅掌握了技术规范，更重要的是内化了架构哲学。它会主动思考：“如果我这样设计，是否体现了良好的Agent职责分离？是否符合StateHandler的设计模式？”这已经不是简单的规则遵循，而是某种程度的“架构直觉”的形成。

最终突破：体验的本质性改变

经过几个月实践，终于在私有代码库中找回了那种许愿式开发体验。

现在，当需要添加新功能时，AI会基于完整规范输出符合架构的实现，每一部分都完美体现架构哲学。当需要重构现有代码时，AI不仅能理解架构调整意图，还能提供完整重构方案，确保所有相关组件一致性更新，甚至主动考虑并发处理可能带来的数据一致性问题。

这种体验的改变是本质性的：

• 从教学到协作：不再需要反复解释架构原理，AI已内化设计哲学。
• 从片段到整体：不再是零散的代码修改，而是系统性的架构实现。
• 从被动到主动：AI主动提醒可能问题，主动遵循最佳实践。

最重要的是，这种体验让人重新爱上了软件设计。过去，复杂架构设计意味着漫长开发周期和频繁沟通成本。现在，AI成为架构理念的完美执行者，可以专注于系统设计的创造性思考，而不用担心实现时的偏差。

我们正在见证一个转折点：AI不再是单纯代码生成工具，而是架构哲学的传承者。它不仅理解技术规范，更重要的是理解了设计意图和价值取向。通过精心设计的偏好系统和规范框架，可以让AI成为团队架构文化的守护者，确保每一行代码都体现设计哲学。

这种方法的威力远不止于个人项目。想象一下，如果整个团队都能构建这样的“超级提示词”：新人入职时快速学习和内化团队架构文化；代码审查时AI基于团队价值观提供一致性检查；架构演进时AI确保变更符合既定设计原则。

AI辅助编程的本质是人与AI的协作迭代。而这种协作的最高境界，不是技术层面的配合，而是价值观层面的共鸣。当AI不仅知道怎么写代码，更知道为什么要这样写代码时，就真正实现了从工具使用到伙伴协作的飞跃。

这或许就是下一代开发体验的雏形：不是人适应工具，而是工具理解人；不是标准化的编程模式，而是个性化的架构哲学传承。未来已来，只是还未普及。