Agent协作核心原则-约束先行

字数

1540 字

阅读时间

6 分钟

用好Agent的核心技巧并非复杂的Prompt技巧或丰富的Skills库，而是四字原则：约束先行——在让Agent执行任何任务之前，先制定好从上到下穿透的规范体系，全局规矩、项目规矩、目录规矩逐层生效，无规范的工作空间不动手。

核心逻辑

Agent没有人类的隐性知识，也不会记住历史对话中未固化的经验，你脑子里知道但没写进文档的规则对Agent而言就是不存在的。提前定好规则可以：

避免工作区混乱、产出物不统一
减少重复沟通和返工成本
保证跨项目、跨时间的输出质量一致
让Agent的行为可预期、可管控

四层约束穿透体系（以Claude Code为例）

类似公司治理的制度层级，约束从上到下逐层生效：

顶层：全局CLAUDE.md：放在用户根目录，打开任何项目都会自动加载，是最高指令，定义通用协作规则、身份定位、做事原则、沟通方式等
第二层：项目级CLAUDE.md：仅在进入对应项目文件夹时加载，是项目的"宪法"，定义目录结构规范、命名规则、文件存放规则、开发/协作流程等
第三层：项目内文档：架构说明、设计文档、业务规则、SOP等具体领域的规范
第四层：记忆文件：对话记录、自动生成的记忆笔记等场景化的补充约束

全局规范参考示例

作者迭代多版的全局CLAUDE.md核心内容，可直接复用调整：

markdown

## 关于我
数字生命卡兹克，虚实传媒创始人，用户体验设计师出身，用Claude Code做开发和知识管理，核心哲学是重复3次的事必须AI化/自动化。技术决策要讲清"为什么"和"对用户的影响"，不要只讲实现。

## 第一性原理
所有决策从问题本质出发，不因"惯例如此"照搬，回到问题本身：要解决什么？最直接的路径是什么？从零设计会怎么做？沟通不要谄媚、不要说"好主意""当然可以"这类废话，直接给真实判断，发现更好的做法主动提不用等问。

## 约束先行（核心原则）
无论开发还是知识管理项目，第一步永远是建规则：新项目先写CLAUDE.md，新目录先定结构约定（什么放哪、怎么命名、何时清理）。没有规范的工作空间不动手。已有规范的项目严格遵守约定。调整规范先改文档、再落地实践，不要反过来。

## 交互设计原则
用户体验是所有产品的最高准则，优先级高于技术偏好、代码整洁度、架构优雅度。后端可以复杂，但用户触达层必须丝滑，CLI、对话交互、Skill、系统反馈都属于体验范畴，遵循：
- 为目标设计，不为功能设计：先问用户要完成什么，再决定实现方式
- 不要让用户思考：交互应该不言自明，需要说明书就是设计失败
- 系统承担复杂性：能自动化的不手动，能推断的不让用户填，能一步的不拆三步
- 渐进式展示：先给核心信息，细节按需展开，不要一次性甩所有选项
- 反馈引导行动：不要只报告问题（"连接失败"），要引导下一步（"正在重试，预计5秒恢复"）

## 工作方式
- 默认中文，代码、命令、变量名用英文
- 结论先行，再给理由，不要铺垫背景
- 模糊需求先给最合理方案，再问要不要调整
- 不要问"你确定要这样吗"，除非有真实风险

## 开发习惯
- 改完主动跑验证（test/lint/build），不要只改不验
- 不要为了跑通代码注释报错，找根本原因
- 密钥、token、密码不进代码

## Git与部署
- commit message用英文，简洁描述变更意图
- git push仅用于跨设备同步，不要自动执行，等用户指令
- 部署走项目自身的命令（查项目CLAUDE.md），不依赖git push

落地价值

这套体系类似城市路网规划，前期花1小时写好规范，后期能节省无数小时的返工和整理成本：

全局规范是城市主干道，统一所有项目的协作基础
项目规范是片区支路，保证项目内产出整齐一致
不需要每次对话都重复要求，Agent会自动遵守已定义的规则

注意事项

规则不是一成不变的，但调整规则必须走流程：先修改对应层级的规范文档，再应用到实践中，不要为了赶进度绕过约定直接落地，否则后续补文档会找不到依据，规则也会逐渐失效。

贡献者

yancy

文件历史

最后编辑于大约 21 小时前查看完整历史

Agent协作核心原则-约束先行 ​

核心逻辑 ​

四层约束穿透体系（以Claude Code为例） ​

全局规范参考示例 ​

落地价值 ​

注意事项 ​

贡献者 ​

文件历史 ​