AI Agent Field Guide
AI Agent 实战手册AI Agent Field Guide
房产经纪 · AI 课程笔记For property agents · Class notes

把 AI 变成你的24 小时助理Turn AI into your 24-hour assistant

这份笔记跟着你走。忘了怎么装、忘了某个指令、想做某件事却不知道怎么开口,回来这里,照着步骤一步一步做就行。These notes stay with you. Forgot how to install, what a command does, or how to ask for a task? Come back here and follow the steps one by one.

上课日期 2026 年 10 月 13 日Class: 13 Oct 2026 Claude CodeCodex 零基础友好No coding needed
~/Documents/AI-Work/listing-mont-kiara
01

先搞懂:AI Agent 到底是什么?First: what exactly is an AI agent?

一句话:ChatGPT 是"会回答问题的顾问",AI Agent 是"会动手做事的助理"。它能打开你电脑里的文件、整理资料、写好文案、做出报告,直接存进你的文件夹。In one line: a chatbot is an adviser that answers; an AI agent is an assistant that does the work. It opens files on your computer, organises data, writes copy, builds reports and saves them straight into your folder.

普通聊天 AIChat AI

电话顾问Phone adviser

你描述,它回答。资料要你自己复制贴上,结果要你自己整理存档。You describe, it answers. You copy data in and paste results out yourself.

AI AgentAI agent

坐在你电脑前的助理An assistant at your desk

自己读文件夹、自己动手改、做完交给你检查。每一步重要动作都会先问你。Reads the folder, makes the changes, hands it back for review. It asks before every important action.

你的角色Your role

老板 / 主管The boss

交代清楚任务、提供资料、检查成果、决定要不要发出去。Give a clear brief, supply the data, check the result, decide what goes out.

Claude Code 和 Codex 怎么选?Claude Code or Codex?

Claude CodeCodex
出品公司Made byAnthropicOpenAI
需要的订阅Plan neededClaude Pro / Max(或团队版)Claude Pro / Max (or Team)ChatGPT Plus / Pro(或 Business)ChatGPT Plus / Pro (or Business)
最简单的用法Easiest way inClaude 桌面 App 里的 "Code" 分页The "Code" tab in the Claude desktop appCodex 桌面 AppThe Codex desktop app
记忆文件Memory fileCLAUDE.mdAGENTS.md 这是什么?↓What is this? ↓
适合Good at中文写作细腻、文件整理、长任务Nuanced writing, file work, long tasks已用 ChatGPT 的人上手快、做小工具Quick start if you already use ChatGPT; small tools
详解 · 记忆文件Deep dive · Memory file

CLAUDE.md / AGENTS.md:给 AI 的"员工手册"CLAUDE.md / AGENTS.md: the AI's staff handbook

AI 每开一次新对话,都像新来的助理第一天上班,什么都不记得。记忆文件就是你放在它桌上的一本手册:你是谁、你做哪一区、文案怎么写、哪些事绝对不能做。它每次开工前都会自动先读一遍,你不用每次重复交代。Every new chat, the AI is like an assistant on day one: it remembers nothing. The memory file is a handbook you leave on its desk: who you are, your area, how you write, what it must never do. It reads it automatically before every job, so you never repeat yourself.

它是什么What it is

一个普通的文字档。名字固定:Claude Code 用 CLAUDE.md,Codex 用 AGENTS.md。.md 是 Markdown 格式,用记事本、TextEdit 都能打开。A plain text file with a fixed name: CLAUDE.md for Claude Code, AGENTS.md for Codex. .md means Markdown; Notepad or TextEdit can open it.

放在哪里Where it lives

放在你的工作文件夹里(例如 AI-Work/)。Agent 在这个文件夹工作时就会读到它。In your work folder (e.g. AI-Work/). The agent reads it whenever it works in that folder.

什么时候被读When it's read

每次开新对话(包括 /clear、/new 之后)自动读取。改完文件,下一次新对话就生效。At the start of every new chat (including after /clear or /new). Edits take effect in the next new chat.

有没有记忆文件,差别有多大?What difference does it make?

同一句指令:"帮我写一段这个单位的介绍"Same prompt: "Write a description for this unit"

没有记忆文件Without memory file

"这套豪华公寓坐拥绝佳地段,投资潜力无限,是您不容错过的梦想家园!面积 116 平方米……""This luxurious condo boasts an unbeatable location with unlimited investment potential, your dream home awaits! 116 square metres…"

  • 夸大用语("潜力无限")Exaggeration ("unlimited potential")
  • 用平方米,不是 sq ftSquare metres, not sq ft
  • 没有 psf、没有你的联系方式No psf, no contact details
有记忆文件With memory file

"Mont Kiara 高楼层 3 房,1,250 sq ft,东北向免西晒。步行 5 分钟到国际学校。售价 RM 1.18M(RM 944 psf)。看房请 WhatsApp 陈小姐 012-345 6789。""High-floor 3-bed in Mont Kiara, 1,250 sq ft, NE facing with no afternoon sun. 5-minute walk to international schools. RM 1.18M (RM 944 psf). WhatsApp Ms Tan at 012-345 6789 to view."

  • 你的区域、你的单位习惯Your area, your units
  • 语气克制专业Measured, professional tone
  • 自动附上联系方式Contact details added automatically

三层手册:越靠近工作的文件夹,越优先Three layers: the closest folder wins

① 全局手册:所有文件夹都适用① Global: applies everywhere~/.claude/CLAUDE.md · ~/.codex/AGENTS.md放:你的名字、联系方式、写作风格For: your name, contact, writing style
② 工作文件夹手册② Work folderAI-Work/CLAUDE.md放:主攻区域、客户类型、通用规则For: your areas, client types, general rules
③ 单一任务手册(可选)③ Single task (optional)AI-Work/leads/CLAUDE.md放:客户分级规则、Excel 栏位说明For: lead grading rules, column meanings

新手只要第 ② 层就够了。两份写法冲突时,以越"里面"的那一份为准。Beginners only need layer ②. If two files disagree, the innermost one wins.

应该写什么?What to put in it

✓ 适合写进去✓ Good to include
  • 你是谁、做哪一区、主攻什么房型Who you are, your area, property types
  • 客户是谁(首购、投资、外国买家)Your clients (first-timers, investors, foreigners)
  • 写作风格、语言、字数习惯Writing style, languages, length
  • 固定格式:sq ft、psf、价格写法Fixed formats: sq ft, psf, price style
  • 禁止事项:不夸大、不删原档Never-do rules: no hype, no deleting originals
  • 文件夹里各文件是什么What each file in the folder is
✗ 不要写进去✗ Keep out
  • 密码、银行户口、身份证号码Passwords, bank accounts, ID numbers
  • 客户的个人资料Clients' personal data
  • 只用一次的临时任务(直接在对话说就好)One-off tasks (just say them in the chat)
  • 很长的文章(越短越清楚,建议一页内)Long essays (keep it to about one page)

房产经纪范本(复制后改括号)Template for property agents (copy, then edit brackets)

CLAUDE.md / AGENTS.md
# 关于我
- 我是 [名字],[城市] 的房产经纪,[公司名],执照编号 [REN 号码]
- 主攻:[Mont Kiara / Bangsar] 的 [公寓 / 有地住宅],价位 [RM 600k–2M]
- 客户:多数是 [首购家庭 / 投资者 / 外国买家]
- 联系方式:WhatsApp [号码]

# 写作风格
- 中文用简体,英文用英式拼写;需要时两种语言各一版
- 语气专业、亲切、克制;不要用"稳赚""保证升值""潜力无限"
- 面积一律用 sq ft;价格同时写总价和 psf(例:RM 1.18M / RM 944 psf)
- 房源文案结尾附上我的联系方式

# 工作规则
- 资料里没有的信息标【待确认】,不要自己编
- 不要修改或删除任何原始文件,输出存成新文件
- 大任务先给我计划,我确认后再做
- 数字要从文件计算,不可估计

# 文件夹说明
- listing-*/ :每个房源一个文件夹,内含 details.txt 和 photos/
- leads/ :客户名单
- reports/ :市场报告
CLAUDE.md / AGENTS.md
# About me
- I am [name], a property agent in [city] with [agency], licence no. [REN number]
- Focus: [condos / landed homes] in [Mont Kiara / Bangsar], [RM 600k–2M]
- Clients: mostly [young families / investors / foreign buyers]
- Contact: WhatsApp [number]

# Writing style
- British English; give a Chinese version too when asked
- Professional, warm and measured; never "guaranteed returns" or "unlimited potential"
- Sizes always in sq ft; show total price and psf (e.g. RM 1.18M / RM 944 psf)
- End every listing text with my contact details

# Working rules
- Mark anything not in the data as [TO CONFIRM]; never invent it
- Never change or delete original files; save output as new files
- For big jobs, show me a plan first and wait for my OK
- Calculate numbers from the files; never estimate

# Folder guide
- listing-*/ : one folder per listing with details.txt and photos/
- leads/ : client lists
- reports/ : market reports

怎么建立和修改?三种方法Three ways to create and edit it

  1. A
    让它自己写(最简单)Let it write the file (easiest)直接说:"请建立 CLAUDE.md,内容如下……",把上面的范本贴进去。Codex 就把名字换成 AGENTS.md。Say: "Create CLAUDE.md with the following…" and paste the template. For Codex, use AGENTS.md.
  2. B
    用 /init 自动生成Generate it with /init输入 /init,它会看一遍文件夹再写出初稿。之后再补上"关于我"和"写作风格"。Type /init; it scans the folder and writes a first draft. Then add your "About me" and "Writing style".
  3. C
    平时随口补充Add rules as you go发现它一直犯同一个错,就说:"把这条规则加进 CLAUDE.md:价格一律写到小数点后两位 M"。Claude Code 也可以输入 /memory 直接打开修改。If it keeps making the same mistake, say: "Add this rule to CLAUDE.md: always write prices to two decimal places in M." In Claude Code you can also type /memory to open and edit it.
小提醒Note在 Mac 上,名字前面有"."的文件夹(例如 ~/.claude)默认是隐藏的。在 Finder 按 ⌘+Shift+. 就能看到。On a Mac, folders starting with "." (like ~/.claude) are hidden. Press ⌘+Shift+. in Finder to show them.
建议Tip两者用法几乎一样。先挑一个你已经在付费的用熟,再试另一个。本手册每一步都同时写了两者的做法。They work almost the same way. Master the one you already pay for first. Every step in this guide covers both.
02

安装与设定(一次搞定)Install & set up (once)

先选工具,再选电脑系统。每做完一步就打勾,进度会自动记在你的浏览器里。Pick your tool, then your computer. Tick each step when done; progress is saved in your browser.

卡住了?常见问题Stuck? Common fixes

03

黄金 5 步工作法The 5-step routine

不管做什么任务,都照这个顺序。熟了以后,你会发现 90% 的工作都能套进去。Whatever the task, follow this order. Once it sticks, 90% of your work fits into it.

  1. 开一个文件夹Make a folder一个任务一个文件夹,例如 listing-mont-kiaraOne task, one folder, e.g. listing-mont-kiara
  2. 把资料放进去Drop the files in房源资料、照片、Excel、PDFListing details, photos, Excel, PDFs
  3. 在该文件夹打开 AgentOpen the agent thereApp 里选文件夹,或终端 cd 进去Pick the folder in the app, or cd into it
  4. 用公式交代任务Brief it with the formula背景 + 任务 + 资料 + 格式 + 限制Context + task + files + format + limits
  5. 检查、追问、存档Check, refine, save不满意就说"改成…",满意就"存成文件"Say "change it to…" until happy, then "save it"

建议的文件夹结构Suggested folder layout

Documents/
└── AI-Work/                ← 所有 AI 工作都放这里 / all AI work lives here
    ├── CLAUDE.md           ← 你的个人资料与写作风格 / your profile & style (Codex: AGENTS.md)
    ├── listing-mont-kiara/ ← 一个房源一个文件夹 / one listing per folder
    │   ├── details.txt
    │   └── photos/
    ├── leads/
    │   └── leads-oct.xlsx
    └── reports/
04

功能大全:每个按键、每个指令是做什么的Every function: what each key and command does

点开任何一张卡片,看"白话解释"和"房产经纪怎么用"。绿色标签 = 第一天就要会;金色 = 进阶。Open any card for the plain-English explanation and an agent's use case. Green tag = learn on day one; brass = advanced.

两个工具更新很快,若名称略有不同,在输入框打 / 就会列出当前版本所有指令。Both tools update often. If a name differs, type / in the input box to list every command in your version.

05

房产实战场景:照着做就有成果Real-estate playbooks: follow and get results

选一个你今天就想完成的任务。每个场景都有:要准备什么、完整步骤、可一键复制的指令、做完要检查什么。Pick a task you want done today. Each playbook lists what to prepare, every step, a one-click prompt, and what to check.

06

指令生成器:不会写?填空就好Prompt builder: fill in the blanks

好指令 = 背景 + 任务 + 资料 + 格式 + 限制。左边填,右边自动组合,复制贴进 Agent 即可。A good prompt = context + task + files + format + limits. Fill in the left, copy the result on the right into your agent.

5. 限制(可多选)5. Limits (pick any)
你的指令Your prompt

小技巧:大任务先加一句"先给我计划,我确认后再做"。Tip: for big jobs add "show me a plan first, wait for my OK".

07

安全守则:用得放心Safety rules: use it with confidence

AI 是助理,不是签字的人。成果要你过目、你负责。The AI is your assistant, not the signatory. You review it and you own it.

08

速查表 & 名词解释Cheat sheet & terms

截图存在手机里,忘了就看一眼。Screenshot this to your phone for a quick look.

听不懂的名词Jargon, decoded

09

延伸学习Keep learning

官方文件最准确;YouTube 上很多博主有实操示范,搜索关键字就能找到最新的。Official docs are the most accurate; YouTube creators show it hands-on. Search to find the latest.

10

更新日志What's new

这份手册会持续更新。收藏这个网址,回来就能看到最新内容。This guide keeps growing. Bookmark the link and come back for new material.

  • 新增"记忆文件详解":CLAUDE.md / AGENTS.md 是什么、放哪里、写什么、房产经纪范本。Added a memory file deep dive: what CLAUDE.md / AGENTS.md are, where they live, what to write, plus an agent template.
  • 第一版上线:安装步骤、功能大全(Claude Code + Codex)、8 个房产实战场景、指令生成器、安全守则、速查表。First release: setup, function guide (Claude Code + Codex), 8 real-estate playbooks, prompt builder, safety rules, cheat sheet.