96SEO 2026-06-22 13:20 2
嘿,兄弟们,今天聊聊这个“为何不先设工程规范再让AI进Plan模式?”的坑。你以为这只是个技术问题?其实它geng像是我们跟AI谈恋爱之前得先约定好规则。别着急,我会把它拆成几块,让你一口气kan完也不会睡着。
先说一句:Plan模式到底是什么?Plan模式,就是给AI一个思考的空间,让它先Zuo个大纲,然后再确认后动手实现。听起来挺靠谱,但Ru果没有前置的“家规”,AI就可Neng在大纲里跑偏,Zui后我们得回头改代码、复查。想象一下你给朋友写一段代码,却没告诉他项目的目录结构、命名规范,那他到底该怎么写?这可就像给小孩送零食,却不知道他们Neng不Neng吃糖。

我常用四层治理模型来梳理:决策层、规则层、角色层、流程层。下面随便抛几个例子,你Ke以把它当作自己的“工程词典”。
改前端页面 → 重点kan FRONTEND-DECISIONS + FRONTEND-BUSINESS-DECISIONS
改后端接口 → 重点kan DECISIONS + BACKEND-BUSINESS-DECISIONS
改跨端流程 → 重点kan BUSINESS-DECISIONS + 前后端业务决策
Zuo安全审查 → 重点kan认证、Token、权限、日志相关决策
这比一个几千行的大规范文档geng易维护,也geng易让AI执行。
决策层:说明为什么这么Zuo
↓规则层:说明具体必须怎么Zuo
↓角色层:说明谁来Zuo
↓流程层:说明按什么步骤Zuo
对应到项目文件,大致是:
/project-plan 新增文章详情页并支持点赞
这个命令内部先加载决策文档,再进入计划阶段。
代码写完
↓Review发现问题
↓返工
有了Claude Code治理体系后geng像是:
当前状态管理方案是什么?为什么选它?哪些场景必须用?哪些场景不需要?
后续演进时就Neng先改决策,再同步rules和skills。
前端只负责展示和交互,这点你一定要记住点赞结果必须以后端返回为准。页面不Neng自己用本地状态裁决业务结果。
这才是决策加载制度的价值:不是替代决策文件,而是在关键任务开始前,要求AI先找到正确的决策依据。
因为 Plan 模式只Neng保证:
AI 会先想一想。AI 会先给一个方案。AI 会等你确认后再动手。
它不Neng天然保证:
业务边界Yi知;
技术栈一致;
目录结构符合团队约定。
"为什么百度不收录"——那是什么鬼?说实话,有人问过“为什么百度不收录我们的技术博客”。答案hen简单——内容缺乏结构化标签,且没有满足搜索引擎算法里的信任度指标。换句话说Ru果你的文章里没有清晰的标题标签(如, , ),或者缺少关键词密度调控,就算内容再牛逼,也可Neng被忽略。所以在写这篇文章时我特意加了hen多, , 并且自然嵌入关键词“工程规范”“Plan模式”“AI开发”,希望百度Nenggeng好抓取到。
不过别担心,这并不是重点,我们还是要聊聊如何让 AI 真正听从我们的指挥。
咱就是说制定规范就是给 AI 打卡签到表。A1: 决议文件决定方向 A2: 规则文件规定细节 A3: 角色文件告诉谁干活 A4: 流程文件安排步骤
Ru果你把这些拆得清清楚楚,那 AI 在 Plan 阶段就Neng直接读取对应文件,而不是靠自己摸索。这就像你走路前往机场,要事先知道哪个航站楼哪条登机口,不然你会一直找不到出口。
举个例子:
我geng推荐把决策文件拆清楚,而不是只写一个hen大的“项目规范”。举个实际场景:
#1 前端新页面: 放到apps/web目录下;组件命名遵循PascalCase;所有请求走service;不要直接使用axios。
#2 后端新增接口: 判断属于auth-service还是backend;在对应服务目录下创建Module、Controller、Service、DTO;通过DTO定义请求和响应结构;跨服务调用走HTTP API,不直接访问数据库。
#3 日志Neng力: 放到packages/shared-logging或services/log-service中;统一日志格式;全局捕获异常并返回标准错误码。
#4 安全审查: Token永远不要存本地Storage;所有接口dou需鉴权检查;敏感数据加密存储与传输。
那我为什么不用传统的大文档呢?bigger doc = harder to keep up-to-date 小模块geng新快,geng易维护 团队新人上手快 代码质量跟踪方便
所以我geng喜欢分散式文档,比如:
BUSINESS‑DECISIONS.md
FRONTEND‑BUSINESS‑DECISIONS.md
BACKEND‑BUSINESS‑DECISIONS.md
FRONTEND‑DECISIONS.md
DECISIONS.md
每个文件只关注自己领域,然后在CLAUDE.md里建立引用关系,让 AI Neng快速定位。
例如:
text
frontend-developer负责 apps/web 下的页面和组件;
backend-architect负责 services 下的服务边界;
api-contract-reviewer检查服务间API契约;
security-auditor检查认证与权限。
这样,一个新人拿到CLAUDE.md就知道该读哪份文档,也Neng让 AI 在 Plan 阶段自动拉取相应信息。
小结:不要等 AI 写代码才想边界哈哈,有时候我也会犯错:“哎呀,我忘了让 AI kan规则。” 那种时候我得自责一下:“不对不对,应该是先跑规则再跑计划。”
所以我的建议:
立刻把项目拆成四层。
在 CLATUE.md 或 CLAUDE.md 中建立索引,让 AI 一眼kan到相关文档路径。
在 Plan 模式里强制读取相关 Decision 文档,以确保规划阶段Yi知边界。
保持迭代—每次新功Neng上线后dou回头geng新 Decision 与 Rule 文档。
毕竟我们跟 AI 合作,就像跟同事合作一样。Ru果同事没有明确职责与流程,你又怎Neng高效协同?
那么Ru果我Yi经有了老旧的大规范怎么办?别急,我有两招:
1️⃣ 把大文档拆成多个小模块,每个模块对应一个业务域或技术栈。例如把所有关于 API 的规则集中在BACKEND‑RULES.md里把 UI 风格指南单独放到FRONTEND‑STYLEGUIDE.md。
② 在每个模块顶部加入一句话,例如:“本节仅适用于 X 服务或 Y 页面”。这样即使你打开整个仓库,也Neng快速定位所需内容。
Zui后的感受说实话,在过去几年里我也经常觉得 “Plan 模式” 就像一张万Neng图。但实际上,它只有在配合完善的治理体系才Neng发挥Zui大价值。所以当你准备让 AI 承担geng多编码任务时请记住——不要等到代码生成完成才去追根溯源,而是要从一开始就把工程规范塞进 AI 的脑袋里。
好了小伙伴们,希望这篇文章帮你理清思路,让你的团队与 AI 的合作geng加顺畅。不管未来技术怎样变革,只要我们坚持用心制定规范,并将其系统化,就Neng让机器真正成为人类Zui可靠的助手。而且——放心吧,你永远不会被告知“这个函数太长”而无从下手,因为所有逻辑douYi经被拆解到了各自的小责任区内。
祝编码愉快,你们Ke以随时来讨论geng多细节!
作为专业的SEO优化服务提供商,我们致力于通过科学、系统的搜索引擎优化策略,帮助企业在百度、Google等搜索引擎中获得更高的排名和流量。我们的服务涵盖网站结构优化、内容优化、技术SEO和链接建设等多个维度。
| 服务项目 | 基础套餐 | 标准套餐 | 高级定制 |
|---|---|---|---|
| 关键词优化数量 | 10-20个核心词 | 30-50个核心词+长尾词 | 80-150个全方位覆盖 |
| 内容优化 | 基础页面优化 | 全站内容优化+每月5篇原创 | 个性化内容策略+每月15篇原创 |
| 技术SEO | 基本技术检查 | 全面技术优化+移动适配 | 深度技术重构+性能优化 |
| 外链建设 | 每月5-10条 | 每月20-30条高质量外链 | 每月50+条多渠道外链 |
| 数据报告 | 月度基础报告 | 双周详细报告+分析 | 每周深度报告+策略调整 |
| 效果保障 | 3-6个月见效 | 2-4个月见效 | 1-3个月快速见效 |
我们的SEO优化服务遵循科学严谨的流程,确保每一步都基于数据分析和行业最佳实践:
全面检测网站技术问题、内容质量、竞争对手情况,制定个性化优化方案。
基于用户搜索意图和商业目标,制定全面的关键词矩阵和布局策略。
解决网站技术问题,优化网站结构,提升页面速度和移动端体验。
创作高质量原创内容,优化现有页面,建立内容更新机制。
获取高质量外部链接,建立品牌在线影响力,提升网站权威度。
持续监控排名、流量和转化数据,根据效果调整优化策略。
基于我们服务的客户数据统计,平均优化效果如下:
我们坚信,真正的SEO优化不仅仅是追求排名,而是通过提供优质内容、优化用户体验、建立网站权威,最终实现可持续的业务增长。我们的目标是与客户建立长期合作关系,共同成长。
Demand feedback