LESSON 04 · CODE 代码

第4课:给 Agent 立家规

代码模块 · 4/7

Why this lesson · 为什么值得学

学完这一课,你能

说清为什么 Agent 需要一份「家规」

掌握家规的五段骨架

拿出一份改两处就能用的家规

为什么 Agent 需要家规

聊天工具说错一句话,顶多给你一条不对的答案。但 Agent 能动手——读文件、写代码、甚至帮你发东西。能力越大,越需要边界。

想象你请了一位新同事进公司。你不交代规矩,他可能好心办坏事:误删了文件、把密钥写进了公开代码、或者没问你就发了封邮件。不是他坏,是没人告诉他边界在哪

「家规」就是写给 Agent 的那份规矩。它通常在你的项目根目录里,叫 CLAUDE.mdAGENTS.md(名字不同产品略有差别,作用一样)。先立规矩,再让它干活,比事后擦屁股省心得多。

家规的五段骨架

一份好用的家规,通常包含这五段。不必一次写满,先有骨架,再慢慢补:

红线是家规里最重要的一段。把「哪些事必须等我确认」写清楚,Agent 才不会好心办坏事。这一条,建议你每条都保留。

一份可以改两处的模板

下面是一份中性化模板。你只要改两处——把项目名换成你的,把「技术栈」换成你实际用的——就能直接用。

# 项目家规

## 思维原则
- 从问题本质出发,给真实判断,不谄媚、不编造。
- 不确定的事明确说「我不确定」,并告诉你怎么核实。

## 约束先行
- 动手前先确认目标与目录结构。
- 大改动先出方案,等我点头再改。

## 沟通方式
- 一次只问一个问题。
- 改之前先复述你对需求的理解。
- 每步说明:做到什么样子,算这一步完成。

## 自主边界(红线,必须等我确认)
- 不删除重要文件;不修改密钥/配置里的敏感信息。
- 不强制推送代码;不安装全局依赖。
- 不公开发布、不对外发送任何内容。

## 工程纪律
- 改完主动验证结果。
- 不靠注释掉报错来绕过问题。
- 密钥、令牌绝不写进代码。

现在就改两处

  1. 把模板里的「项目家规」标题,换成你正在做的项目名(比如「我的个人主页」);
  2. 在「工程纪律」下补一句你的具体技术栈(比如「本项目是单个 HTML 文件,用纯前端,不需要后端」)。

改完这两处,你就有了第一份家规。把它存成项目根目录下的 CLAUDE.md,下次让 Agent 干活前,先让它读一遍。

本课收尾

家规不是一次写死的东西。用一阵子,你会发现有哪条它总犯、哪条你没想到——那就补进去。好的家规是和 Agent 一起长出来的

带走三句话:① Agent 能动手,所以要有边界;② 家规五段:原则 / 约束 / 沟通 / 红线 / 纪律;③ 红线那段,一条都别省。

REFERENCES · 参考资料

本课参考资料

  1. Agent 上手路线包(用户提供的课程素材)· 全局家规模板(已中性化:去除具体工具绑定与商业语气,保留五段骨架)
  2. 智能体模块《怎么用好 Agent?》(人类守关口与沟通纪律)
← 上一课:从聊天到自动化下一课:第一次开口做网页 →

有疑问?返回 主页,或直接问你的 AI 助手:「帮我把这份家规改成适合我项目的版本。」